PicSell Component Documentation

plumpbustlingInternet και Εφαρμογές Web

4 Δεκ 2013 (πριν από 3 χρόνια και 8 μήνες)

204 εμφανίσεις


PicSell

Component

Documentation



Installation Instructions


Login to your Joomla admin panel > Extensions > Install /Uninstall > Click on browse
and locate the file com_picsell.zip and then click on “Upload and Install”


You are done with installation.


C
onfiguration settings


Directory settings


You need to create three different directories for
categories images
,
Thumbnail images,
full images. Please make sure the directory browsing disabled for all these three
direc
tories. Please make all the three dire
ctories writable

(777

permission
)

by your
program
.


Go to Components > Pic
Sell. Then click on Parameters, enter the “
Categories Images
Folder
”, “
Thumbs and Watermark Images Folder
” and “
Images for sale Folder
” paths.

The default directories will be “
compon
ents/com_picsell/galleries
” for Category images,

components/com_picsell/gallery
” for thumbnail and watermarked images and

components/com_picsell/selling
” for original images. You can override these default
settings.


Thumb images and watermark images wil
l be saved in same directory.


Currency settings


In “Parameters settings” please select the currency USD, EUR or

GBP which ever is your
option. Please mention the currency symbol in “
Currency symbol
” field.


Watermark Settings


Please note that the waterm
ark will be created while you are uploading the images. If you
want to change the watermark on an image, you have to upload that image again with
required watermark settings.


Configure the watermark color in “
RGB color of watermark
”. The RGB code should b
e
comma separated.



Configure transparency in “Alpha”. The values should be
in
between 0 to 127
.

0 will be
no transparency, 127 will be full transparent.


Configure the font size and font family

as well.


Configure the x and y co
-
ordinates in order to po
sition the watermark on the big image.


Configure the Watermark text.


Payment Gateway Settings


Currently the component supports only paypal payments.
It works with paypal API in
order to make the transactions secure.


It is easy to get paypal API Userna
me, password and Key. It will hardly takes a minute to
get the above API details.

Please follow the steps below.


1.

Login to your paypal Account

2.

Go to My Account > Profile > API Access




You will get the following options




Click on Request API credenti
als





Use
your

credentials to configure your PicSell component
paypal
parameters.

You can enable or disable test payments for using paypal sandbox.



Manage picture Downloads


You can specify how many times a picture can be downloaded after purchasing t
he
picture. Specify the number of download limits in “
Links Max Clicks
” field. If the
link got more than specified clicks, it will expire.


You can also set the lifetime of a download link. Please use “
Days expire
” to set the
time limit for a download lin
k.


You can also enable the expired link by following ways.


If the link expires by meeting its maximum clicks, go to “Links” then click on “reset”
to reset the number of clicks.


If the link expires by its lifetime, go to “Links” then click on “renew” to

enable the
link again.


Click on “deny”
to disable any working download link.


Email Settings



Please configure mail from, mail subject, and message using component parameters.


Other settings


Option

Usage

Categories per row


Specify the number of cate
gories per row

Categories Thumbs Width

Width of the category thumbnail images

Categories Thumbs Height

Height of the category thumbnail images

Containers Width

The width of the category thumbnail images
container

and product images
container

Categorie
s Scroller Height

Height of the categories scroller

Scroller Background

Color

Background color of the container

Scroller Border Color

Border color of the container

Category thumbs border color

Border color of the category thumbnails

Category thumbs
Bac
kground

color

Background

color of the category thumbnails

Category
Tooltip font color

Font color of the tooltip messages

Number of columns

Number of columns of images to show

Number of rows

Number of rows of images to show

Distance between rows

Specify

the distance between any two rows of
the images. Measurement in Pixels.

Distance between rows

Specify the distance between any two rows of
the images. Measurement in Pixels.

Thumbs width

Width of the thumbnails

Thumbs height

Height of the thumbnails

Picture title color

Color of the image titles

Set Metadata

Set the meta keywords and meta description of
the Picsell component page.

Add Jquery

Default value “yes”. If you are using jquery file
in your template itself and if you don’t want it
瑯⁢攠楮t
汵摥搠ly⁣潭灯湥湴Ⱐ灬ea獥⁳ lec琠
“No”.

䅤搠橑略ry⁴潯 s

Default value “yes”.
f映y潵⁡牥⁵獩ng煵敲y

瑯潬s

晩汥⁩渠y潵爠瑥浰mate⁩ 獥汦⁡湤⁩映y潵o
don’t want it to be included by component,
please select “No”.




Pictures Show Size Type


It is about how

you want to display your pictures in the front end.
Please try different
options and see the different in the front end to understand it better.



Order Management


In “Orders”, you can view all the order details. You can find orders in specific date rang
e
by applying date filter. You can also sort the order by amount, first name of buyer, last
name and by date. It is possible to filter the orders by status of the transaction: paid,
Pending, Not paid, Manual limited and Manual unlimited.


St
atus

definition
s


Paid
: When the customer add
ed

items to cart and checkout and paid successfully with
paypal.


Pending
: The customer added items to the cart, paid successfully and the transaction is
not processed or has some problem at payment gateway
.


Not Paid
: When t
he customer adds items to cart
then

checkout and quits at payment
gateway without paying.


Manual Limited
:
Order created manually using “Make Links” and the download link has
limited clicks and expiry time.


Manual Unlimited
:

Order created manually using “
Make Links” and the download link
has no limited clicks and no expiry time.



Sending free downloadable links


If you want to send free downloads, go to pictures
and select

one or more
picture
s

that
you wanted to send

then

click on “Make Links”
. Fill up th
e form and save.



Make links


form elements


Image I
D’s
: It is the
ID
’s of the images that you want to send.

Amount
: The equivalent amount of the images.

E
-
Mail
: Recipient email address.

Payer ID
:
It is just a reference to that order. You may use this a
s payer id in paypal.

First Name
: First name of recipient

Middle Name
: Middle Name of recipient

Last Name
: Last name of the recipient.


Transaction ID
: Transaction ID if there is any related transaction

Links type
: Limited will have limited clicks and expi
ry time. Unlimited will not have
expiry or click limits.


Tooltip


It is optional to show or hide the tooltip for catego
ries or items under categories. There
are two sizes and two colors of tooltips available, big, small, white, black, with arrow,
and with
out arrow. You can choose any style.