Shopping Cart

If you've read the shoppingcart.xml section, you should be able to understand how to configure most of the shoppingcart settings. This section covers each settings/aspects of using the shoppingcart feature in detail.

 

Features:

 

1. Email order, PayPal, Google Checkout, Offline Order, Credit card checkouts

2. Ability to customize price and sizes for each image

3. Shipping based on quantity or subtotal amount or each additional item bought

4. Ability to change the shipping based on regions

5. Sales Tax

6. Discount based on quantity or subtotal amount

7. Display custom message in viewcart and checkout screens.

8. Help button

9. Fully customizable labels, texts, buttons, error messages for multi language support

10. Optional custom input fields

11. Terms and Conditions checkbox

12. Automated Digital image download on successful PayPal payment

13. Discount coupon based on $ and %

14. Ability to restore the cart contents if the buyer want to change the items after selecting paypal, googlecheckout or creditcard checkout button

15. Option to decide which input fields are required in the checkout screen

16. Ability to remember the cart contents when the user revisits.

17. Display Error/Warning message when same image is added to cart

18. Ability to add extra cost for custom fields

19. Total amount rounding

20. Shipping - based on % of total amount

21. Option for the buyer to enter notes for each item added to the cart

22. Shoppingcart in XML format

23. Option to set discount in amount or percentage (based on subtotal or quantity)

24. Option to set tax included in the price

25. Option to restrict a single image from being  added to the cart (Not for sale scenario)

26. Order file in text, html and pdf format

27. Sell packages (package with specific image sizes and quantities)

28. Email notification of order file as an attachment as well as in email body (inline content)

29. Shipping fee based on image size format (different fee for 4X6, 8X10, 11X14...)

30. Shipping fee based on specific format quantities (fee based on total quantities of each size. example: different fee for   two 4X6 images and five 4X6 images )

31. NoChex checkout

32. Option to disable checkout screen fields

 

 

 

Pre-Requisites:

 

1. PHP 4.3 or higher supported web server

2. res/shoppingcart folder in your web album should be set to full WRITE access (CHMOD 777)

 

 

How to Setup:

 

1. Start with taking a backup for the default res/shoppingcart/shoppingcart.xml file in the FotoPlayer skin folder. If you've made any error during customization, it'll be handy to refer this backup for the format.

 

2. Open shoppingcart.xml using a plain text editor like Windows wordpad or Mac Textedit. (using editors like Microsoft word will corrupt the XML format)

 

3. Editing <format> tags.

 

<format id="format1" size="4 x 6" price="10" type="print" category=""></format>

 

Place where you can customize the image size, price , type and category.

    

    id:            Unique name for each format tag. This will be cross referred when using Package feature and setting discount/shipping fee based on each format.
 

    type:        If you're taking order and printing them yourself, set it to 'print'. If you're selling digital images, set it to 'digital'. Do not change to some other text.
 

    category:  Leave it blank if the image format and price applies to all images in your album. If you want to change the price or provide specific size for an image, you can use this   

                   category parameter to match the category code in image IPTC..

 

How it works:

Example: If you want to sell panoramic images with  different sizes and prices from the rest of the album images,

1. Add IPTC category code as 'PAN' for all panoramic photos (use iptc editor like IrfanView)
 

2.  Enable 'Shoppingcart custom price' feature in the skin settings Options->shoppingcart tab and select 'IPTC Category'. Some IPTC editors allows only max 3 character for IPTC Category. If you wish to use code more than 3, you can use IPTC Supplemental Category or IPTC Object name.

 

3. Define <format> tags in  shoppingcart.xml to use category code 'PAN'

Example:

  <format id="format10" size="11 x 5" price="50" type="print" category="PAN"></format>

  <format id="format11" size="23 x 8" price="100" type="print" category="PAN"></format>

 

4. When viewing the album, the above image formats and price will only be displayed for those images for which you've added PAN IPTC category code.

 

 

5. If you want to disable some of the images for sales, use IPTC Category code as NFS and in the format tag set type as "notforsale"

Example: <format id="format12"  size="NOT FOR SALE" price="0" type="notforsale" category="NFS"></format>

 

 

4.  Defining Packages.

 

    You can define package tags within <entry> tag. There is no limit to the number of package tags you can define. If you don't wish to sell any packages, you can delete the entire <package> tag. Shipping and discounts will not be applied to packages.

 

    <package name="StandardPackage" description="Standard Package Demo" price="50">

                <includeformat id="format1" quantity="3" />                        

                <includeformat id="format3" quantity="2" />                        

    </package>

 

    For the above example, "Standard Package Demo" will be the package title displayed in the cart first screen. Package includes  3 quantities of '4 x 6 framed' and 2 quantities of 5 x 7
Note: formatname you define in includeformat tag should match with the size definitions in <format> tag (Refer Step 3). You can add any number of
<includeformat> tags.

 

 

 

 

5. Setting Shipping price

 

If you want to use the shipping feature, set shipping="Y" in <order> tag.

<order savecart="Y" currencysymbol="$" shipping="Y" ...

 

Decide which method of shipping price you want to use.

1. based on quantity

2. based subtotal amount

3. based on each additional item bought

4. based on size format of each item added to cart

5. based on specific size format quantities

 

 

For shipping based on quantity:

 

a. In <order> tag at the starting of this file, you'll find "shmode" parm. Set it to 1.

<order savecart="Y" currencysymbol="$" shipping="Y" shmode="1" ...

 

b. Customize the shipping price for each quantity range in <shippinghandling mode="1" .. tag.

Example:

  <foritems from="1"  to="5">2.00</foritems>

  <foritems from="6"  to="10">4.00</foritems>

Shipping price $2 will be applied for quantities from 1 to 5 and $4 for 6 to 10 quantities. You can add any number of range by adding more <foritems> tags.

 

 

 

 

For Shipping based on Subtotal amount:     

 

a. Set shmode="2" in <order> tag.

<order savecart="Y" currencysymbol="$" shipping="Y" shmode="2" ...

 

b. Customize the price for different subtotal amount ranges in <shippinghandling mode="2" type="AMT" .. tag.

Example:

  <foramount from="1"  to="49.99">2.00</foramount>

  <foramount from="50"  to="99.99">3.00</foramount>

Shipping price $2 will be applied for amounts from 1 to 49.99 and $3 for amounts from 50 to 99.99. You can add any number of range by adding more <foramount> tags.

 

 

If you want to set the shipping value a % of the total amount, use <shippinghandling mode="2" type="PER" ...

When type is set to "PER", FP will consider the shippingvalue as %.

For example, if the total amount is in the range 1 to 49.99 ( example: $20), then 2% of $20 ($4)  will be charged ad shipping price.

 

 

 

For Shipping based on each additional item bought:

 

a.  Set shmode="3" in <order> tag.

<order savecart="Y" currencysymbol="$" shipping="Y" shmode="3" ...

 

b. Customize the shipping price by editing <shippinghandling mode="3" .. tag.

Example:

  <foritems from="1"  to="2">4.00</foritems>

  <foradditional>0.50</foradditional>

$4 shipping cost will be applied if number of items is in range 1 to 2 and for each additional item $.50 will be added.

 

 

 

For shipping based on size format of each item added to cart:

 

a.  Set shmode="4" in <order> tag.

<order savecart="Y" currencysymbol="$" shipping="Y" shmode="4" ...

 

b. Customize the shipping price by editing <shippinghandling mode="4" .. tag.

Example:

<shippinghandling mode="4" minimumshippingfee="5" maximumshippingfee="20" comment="Fee applied for each item added to cart based on the size format" >

  <item id="format1">1</item>

  <item id="format2">2</item>

  <item id="format3">3</item>

  ...

  ...

</shippinghandling>

 

For the above example, $1 charged for each item of size "4 x 6" (which is format1), $2 for "4X6 framed" (which is format2)

 

 

 

 

For shipping based on specific size format quantities:

 

a.  Set shmode="5" in <order> tag.

<order savecart="Y" currencysymbol="$" shipping="Y" shmode="5" ...

 

b. Customize the shipping price by editing <shippinghandling mode="5" .. tag.

Example:

  <shippinghandling mode="5" comment="based on specific format quantities">

        <format id="format1">

         <foritems from="1"  to="5">2.00</foritems>

         <foritems from="6"  to="10">3.00</foritems>

         <foritems from="11" to="999">10.00</foritems>

     </format>

     ...

     ...

     <format id="format11">

         <foritems from="1"  to="999">20.00</foritems>

     </format>        

</shippinghandling>      

 

For the above example,

for "4 X 6" size images in the cart (which is format1) , if there are 5 quantities in the cart, fee of $2 will be applied. For quantities from 6 to 10, $3 will be applied.

for "23 x 8" size images in the cart (which is format11), fee of $20 will be applied for quantity 1 to 999.

 

 

6. Setting shipping price variance.

 

If you're using shipping feature, you'll notice in step 4 that you've only set the shipping price that's applies to all buyers irrespective of where they're located. You'll need an option to change the shipping cost based on the buyer location. This Shipping pricevariance feature allows to proportionally change the price you've set in step 4 based on the region the buyer selects in the viewcart screen.

 

<shpricevariance>

  <location name="US">0</location>

  <location name="Europe">100</location>

 ...

 ...

</shpricevariance>

 

In the above example, the shipping price won't change if the user selects 'US' from the regions list. 0 means 0% change.

But if they choose 'Europe', the shipping price will be increased by 100%. If the shipping price is $5, for Europe region, it'll be $10. You can add number of <location> tags.

 

What if you don't want to apply the shipping if the buyer is going to collect the item personally?

You can add an <location> for "no shipping"  and set the % to -100.

<location name="PickUp-No Shipping">-100</location>

 

You can also use shpricevariance to add shipping insurance or type of postage (ordinary/courier).

 

 <location name="UK - RoyalMail">0</location>

  <location name="UK - Insured (ParcelForce)">100</location>

 

 

 

7. Settings Sales Tax.

 

You can enable/disable this feature by setting tax="Y" or "N"  in <order> tag.

 

<salestaxpercent excludeshipping="N" includedinprice="N">

  <state name="Others">0</state>

  <state name="California(US)">7.25</state>

</salestaxpercent>

 

For the above example, no sales tax is added if the buyer selects 'Others' from the list shown in viewcart screen.

For California, 7.25% tax will be applied to the subtotal amount.

You can edit and add any number of <state> tags. If you want to exclude shipping cost from Tax, set excludeshipping="N" as shown in the above example.

 

 If your item already includes the sales tax then set includedinprice="Y". FP will still calculate the tax amount but it'll not be added to the total amount.

 

 

 

8. Setting discounts.

If you want to enable this feature, make sure to set  discount="Y" in <order> tag.

Decide which discount mode you want to use.

  1. based on quantity

  2. based on subtotal amount

  3. based on specific format quantities

 

 

 

Discount based on quantity:

a. Set discountmode="1" in <order> tag.

b. Customize the discount amount for different quantity ranges in <discount mode="1" type="AMT". .. tag.

Example:

 <foritems from="1"  to="5">10</foritems>

 <foritems from="6"  to="10">20</foritems>

$10 discount will be applied for quantites from 1 to 5 and $20 for quantities 6 to 10.

 

 

If you want to set the discount value a % of the total amount, use <discount mode="1" type="PER" ...

When type is set to "PER", FP will consider the discount  value as %.

For example, if the total amount is $20 and if the number of items is 3 then 10% of $20 ($2)  will be applied as discount.

You can edit/add any number of <foritems> tag.

 

 

 

Discount based on Subtotal amount:

a. Set discountmode="2" in <order> tag.

b. Customize the discount amount for different subtotal amount ranges in <discount mode="2" type="AMT". .. tag.

Example:

  <foramount from="1"  to="49.99">5</foramount>

  <foramount from="50"  to="99.99">10</foramount>

5% will be discounted for subtotal amount from 1 to 49.99 and 10% for 50 to 99.99 range.

 

 

If you want to set the discount value a % of the total amount, use <discount mode="2" type="PER" ...

When type is set to "PER", FP will consider the discount  value as %.

For example, if the total amount is $20 ( lies in the range 1 to 49.99) then 5% of $20 ($1)  will be applied as discount.

You can edit/add any number of <foramount> tag.

 

 

 

Discount based on specific format quantities:

a. Set discountmode="3" in <order> tag.

b. Customize the discount amount for different subtotal amount ranges in <discount mode="3" type="AMT". .. tag.

Example:

 <discount mode="3" type="PER" comment="based on specific format quantities. Type can be PER (percent) or AMT (amount)">

        <format id="format1">

         <foritems from="2"  to="5">10.00</foritems>

         <foritems from="6" to="49">20.00</foritems>

         <foritems from="50" to="999">30.00</foritems>

     </format>

 ...

 ...

     <format id="format11">

         <foritems from="2"  to="999">20.00</foritems>

     </format>        

</discount>

 

For the above example,

for "4 X 6" size images in the cart (which is format1) , for quantities 2 to 5, 10% of the fee will be discounted (of the total price of  "4X6" images in the cart)

for "23 X 8" size images in the cart (which is format11) , for quantities 2 to 999, 20% of the fee will be discounted (of the total price of  "23X8" images in the cart)

 

Note: If you wish to set discount of fixed amount instead of percentage, set type="AMT" instead of type="PER".

 

 

 

9. Showing shopping cart Help info for buyers.

 

You can display a Help button in the shoppingcart screen and link it to a page where detailed help on how to use your shoppingcart is shown. For example, your shop pricing, discount, shipping models, your contacts can  be put in this help page.

 

<info show="Y">res/shoppingcart/shopping_help.html</info>

 

If you want to disable the help button, set show="N".Edit shoppingcart_help.html page in res/shoppingcart folder with the help details.

 

 

 

10. Customizing what input fields to be displayed and whether if it's a required field in the checkout screen

 

 

Example:

<checkout>

<reqdata firstname="Y" lastname="Y" email="Y" address="N" ...

<enablefields firstname="Y" lastname="Y" email="Y" address="Y" city="N"  ...

</checkout>

 

Setting the value to "Y" for <reqdata> tag parameters means it's a required field.

Setting the value to "Y" for <enablefields > tag parameters means it's a displayed field.

 

For the above example, the buyer won't be able to proceed with the checkout unless firstname, second name and email ids are filled in. They can ignore entering address.

City field will not be displayed since it's set to "N".

 

 

 

11. Displaying custom message in View cart screen

 

View cart screen is where the selected items are listed and price/discount/shipping/final total amount details are shown.

If you want to display any message just below the cart grid, you can use <viewcartnotes> parm.

 

In the default skin template, the viewcart notes is set to explain the discount/shipping/tax model in plain English. You can customize the text to whatever you want. If you want to disable this message, set viewcartnotes="N"  in <order> tag.

 

 

12. Displaying custom message in Checkout screen

 

You can display custom message/instructions  to the buyers in the checkout screen by editing the text in <sellernotes> tag. For example, you can explain different checkout options, display your contact details etc.

 

 

13. Settings countries list where you can ship

 

The template includes most of the countries name in <countries> tag. You can remove/edit/add entries this list.

 

Example: if you're selling only to US customers,
 

<countries>

<name>United States</name>

</countries>

 

14. Customizing the texts in shopping cart screens

 

The texts displayed in the shopping cart screens are UTF-8 font compatible. FP provides option to customize all the texts displayed (labels, error messages, button texts etc)

 

To customize labels: Edit the texts within <labels> tag.

To customize Error messages: Edit the texts within <error> tag.

To customize the texts in the generated order file: Edit the texts within <orderreport> tag.

To customize button labels: Edit texts within <buttons> tag.

To customize the header texts shown in the view cart grid: Edit texts within <cartheader> tag.

 

 

15. Setting PayPal details

 

1. If you want to enable PayPal checkout feature, set paypal="Y" in <order> tag.

2. Edit settings within <paypal> tag.

a. <business>  

Change the text 'EnterPaypalAccountEmail'  to  use your PayPal account email id.

b. <returnURL>

Option to redirect the buyer from paypal site to your site after successful payment.

If you're using FP automated image download feature, this url needs to be pointed the location where you've paypalreturn.php page. (default is in 'res' folder)

 

If you're not using automated image download, you can set the url to a page where you can put 'thank you' message to the buyer.

 

c. <currency_code>

Set the PayPal currency code.

 

Australian Dollars (A $)           AUD

Canadian Dollars (C $)            CAD

Euros (€)                               EUR

Pounds Sterling (£)                GBP

Yen (¥)                                  JPY

U.S. Dollars ($)                      USD

New Zealand Dollar ($)            NZD

Swiss Franc                          CHF

Hong Kong Dollar ($)              HKD

Singapore Dollar ($)               SGD

Swedish Krona                      SEK

Danish Krone                        DKK

Polish Zloty                           PLN

Norwegian Krone                   NOK

Hungarian Forint                    HUF

Czech Koruna                       CZK

 

d. <url>

Leave the default url unchanged if using the live paypal site. If you want to use PayPal sandbox set the url to,

<url value="https://www.sandbox.paypal.com/cgi-bin/webscr" target="_blank" />

 

Target set to "_blank" will open PayPal window in a new screen. To open in the same FP album window, set target="_self"

 

More info on using Paypal sandbox can be found at https://cms.paypal.com/us/cgi-bin/?&cmd=_render-content&content_ID=developer/howto_testing_sandbox

 

 

16. Setting Email notifications

 

FP can send email notification when an order is placed. You can optionally send the copy of the notification to the buyer also.

Edit settings in <emailsettings> tag.

 

a. <from>

The email originating address (which is usually your email address on your domain where the album is published). This is the email address you'll see it in the 'from' field in your notification.

You can use any email address you want. If you're notifying the buyer, they may reply to that email. so use a valid email address.

 

Example: If your album is hosted on domain.com, 'from' address can be contact@domain.com. You can use your other email ids also.

 

b. <to>

Your email address where you want to receive the order notification.

 

c. <subject>

Email subject.

 

d. Sending order notification copy to the buyer.

To use this feature, set sendcopytobuyer="Y" in  <emailsettings> tag. The order file will be sent to the email address the buyer entered in the checkout screen.

 

e. Option to set if the order file contents to be sent as an attachment or in the email body (inline)

<emailsettings sendcopytobuyer="N" sendasattachment="Y">

 

 

Note: The order info will be sent as an attachment in the same name as the order id in text format.

 

17. Offline ordering:

 

This feature is specifically designed for sellers you publish their album on CD and send it to their clients. Your client can then shop for the images, print the order and send it by fax or by snail mail (or) email the generated order info.

 

To enable this checkout feature, set offlineorder="Y" in <order> tag.

 

You can customize the offline order window title and footer message  by editing <offlineorder> tag entries.

 

18. Customizing footer message in the order file.

 

If you're sending the order file notification to the buyer (See 15.d) , you may wish to set some footer message to display your shop address or some custom notes to the buyer.

 

To customize , edit the text in <orderfooter> tag.

 

 

19. Credit Card Checkout.

 

To enable Credit card checkout set creditcard="Y" in <order> tag and customize <creditcard> tag entries.

 

If you've your own credit card processing merchant gateway tools running on your website, you can link FotoPlayer orders to that script.

 

Linking to credit card script is just one of the way to use this feature. You can also customize this checkout label to say 'Authorize.net' and redirect the user to a page where you've the form for processing authorize.net checkout.

 

To avoid asking buyer to enter their details again in the redirected page, FP will send as much as possible data from the cart to the redirect page using POST. You can retrieve these data and use it to fill your credit card form.

 

The template include a sample redirected page (creditcardpayment.php) . You can edit this page and refer how you can receive the POST data sent from FotoPlayer.

<securedURL> Url where you've hosted your credit card processing script. Usually the page with SSL protected (https://)
<target> to choose if you want to open a popup page or redirect the existing page.

 

 

To use NoChex Checkout:

 

          a. Copy nochexpayment.php file from FP skin PHP folder to FP skin 'res' folder.

b. Edit nochexpayment.php file using wordpad or notepad. Search for dhinakar.com@gmail. and change it to your nochex account email.

          c. Change http://www.fotoplayer.com to your site in the same file.

          d. Edit shoppingcart.xml file in FotoPlayer skin res/shoppingcart folder and enable creditcard checkout feature (search for creditcard="N" and set it to ”r;Y”)

          e. Find creditcardpayment.php in this file and change it to nochexpayment.php.

 

 

 

20. Google Checkout

 

To enable Google checkout set googlecheckout="Y" in <order> tag.

 

Similar to PayPal checkout. You can customize the currency code and the url. This feature can be used only by US/UK sellers/buyers.

Make sure to change the "[[your merchant ID goes here]]" in the URL to your own Google merchant id.

 

 

 

21. Adding Custom fields to the order screen.

 

FP allows to add two optional custom fields in the order screen to get additional preference about the image from the buyer. You can customize the label and the list of possible values for each field by editing <customfields> tag.

 

In the default skin template, both custom fields are enabled and are set to use 'image tone' and 'image fit'  preferences. You can change the field name and it's values.

 

<field1 name="TONE" enabled="Y">

<data extracost="N" value="0" >Color</data>

<data extracost="N" value="0" >Black and White</data>

<data extracost="AMT" value="0" >Sepia</data>

<data extracost="N" value="0" >Blue</data>

<data extracost="N" value="0" >Blue Duotone</data>

<data extracost="N" value="0" >Yellow</data>

<data extracost="PER" value="0" >SoftFocus</data>

</field1>

 

 

You can apply extra cost based on the buyer selection of the custom field value. For example, if you want to charge $5 for black and white image, you can set,

<data extracost="AMT" value="5" >Black and White</data>

 

If you want to charge 5% of the item price for black and white image, you can set,

<data extracost="PER" value="5" >Black and White</data>

If you don't charge any extra fee for the custom field selection, set  extracost="N"

 

 

Above settings can be applied to Custom Field 2 also.

 

 

 

 

22.  Requesting buyer to agree to terms and conditions before checkout

 

To enable this feature, edit the settings within <terms> tag. Make sure to edit termsconditions.html in res/shoppingcart/ with your terms and conditions.

 

 

23. Using Discount Coupon codes.

 

To enable discount coupon feature, set discountcoupon="Y" in <order> tag.

 

Default is to use discount coupon based on amount. But, if you want to use discount coupon based on percentage,

set discountcoupontype_percent="Y" in <order> tag.

 

Discount coupon code settings are kept outside shoppingcart.xml for security reasons. Edit discountcoupons.php in FotoPlayer skin 'PHP' folder. You'll find the instructions in this file  where to make the changes.

 

Setting discount coupon is simple. Just look for the below lines and edit the code and the corresponding value.

 

$coupon_codes = array("FP12345","FP11111","FP22222");

$coupon_discount_value= array("10","20","5");

 

For the above example,

if you're using discount coupon based on amount,

FP12345 will correspond to $10 , FP11111 code will correspond to $20 and so on.

 

If you're using discount coupon based on percentage,

FP12345 will correspond to 10% discount on the subtotal amount  , FP11111 code will correspond to 20% discount and so on.

 

You can edit/remove/add as many coupon codes you want.

 

 

24. Option to restore cart contents.

 

There might be a situation when the buyer wants to review the cart contents even after selecting payal or google checkout or credit card checkout.

 

To enable this feature set restorecontents="Y" in <order> tag. The buyer can close the paypal window, navigate from checkout screen to the viewcart screen and use 'Restore Contents' button to restore the images. The button will be disabled once it's clicked.

 

 

25. Remembering the cart contents when the user revisits

 

By default this feature is enabled. If the user refreshes the album page or close the album window and revisits later, FP will show the previous cart contents. To disable , set savecart="N"  in <order> tag.

 

26. Setting currency symbol / codes.

You can sell images in any Currency.

a. Edit currencysymbol in <order> tag.  You can use currency symbol like $, £ or in codes like USD, GBP...
<order savecart="Y" currencysymbol="$" ...

b. If you're using paypal checkout, make sure to edit the currency code in <paypal> tag. Refer step 14.2.c.

 

 

27. Setting minimum order for the sales.

Minimum amount: Edit minimumamountorder  parm in <order tag. Example: minimumamountorder="50". If the total amount is less than 50, an error message will be displayed on 'checkout' button click. You can customize this error message in <error> tag.

Minimum Quantity: Edit minimumquantityorder  parm in <order tag. Example: minimumquantityorder="5". You can customize the error message in <error> tag.

 

28. Total amount round off

 

 Not all countries currency basic unit is 0.01 (1 cent, 1 pence ...). To make FP compatible, it now support rounding the total amount to the nearest unit (customizable).

 

priceroundoff="0.25" (your currency basic unit)

Example:

 0.25 -> will round off $10.27 to $10.25 , $10.54 to $10.50  , $10.99  to $10.75

 0.50 -> will round off $10.27 to $10.00 , $10.49 to $10.00  , $10.90  to $10.50

 1.00 -> will round off $10.27 to $10.00 , $10.49 to $10.00  , $10.90  to $10.00

 0.01 -> No round off.

 0.00 -> No round off.      

'priceroundoff' value cannot be less than 0 or greater than 1.

 

 

29.  Prefix size info to the image name when selling multiple digital image formats for the same image.

 

Assuming you're using FotoPlayer Paypal automated download feature (buyer can download the images after successful paypal payment), and if you're selling multiple digital formats, you need to have an ability to download different resolution of the same image based on what customer purchased. "prefixsizefordigital" feature is designed to meet this requirement. It prefixes the image name in the order file with the first 4 chars of the size.

 

 

Example:

 

Image name : image1.jpg

Available digital sizes to purchase : 1024X768 , 2048X1536

Set prefixsizefordigital="Y" in <order> tag.

 

If the buyer adds both 1024X768 and  2048X1536 size formats of the same image image1,jpg, then in the order file, you'll notice the item names as,

 

Item: 1024image1.jpg

Item: 2048image1.jpg

 

After successful paypal payment, buyer can download the same image in two different resolution.

 

 

30. Order file format

Default order file format will be plain text file. orderfileformat="TXT" in <order> tag.

 

HTML format:

a. To set it to HTML format, set ordefileformat="HTML" in<order> tag.

b. To customize the logo,  edit res/yourlogo.jpg in the skin folder.

c. By default thumb images are used in the HTML order. You can instead use a medium sized image by enabling the feature in Options->Shoppingcart tab. You can also customize the medium sized image width and height in this tab.

 

Note: When using HTML format, order in text file will still be created (for automated download after payment feature)

 

 

PDF Format:

a. To set it to PDF format, set ordefileformat="PDF" in<order> tag.

b. To customize the logo,  edit res/yourlogo.jpg in the skin folder.

c. By default thumb images are used in the PDF order. You can instead use a medium sized image by enabling the feature in Options->Shoppingcart tab. You can also customize the medium sized image width and height in this tab.

 

Note: When using PDF format, order in HTML format will still be created and linked from the PDF.

 

 

 

31. Disabling  folder name, description and user notes in cart first screen.

Image current folder, image IPTC Caption as description and user input notes feature in the cart first screen can be disabled.

To disable set corresponding paramter value to "N" in <order> tag.

<order ....  displayfolder="Y" displaydesc="Y" displayusernotes="Y">

 

 

 

32. Tone Preview

 

If you're using Image Tone as one of the custom field, you want to provide an option for the buyer to preview the image in Black & White or Sepia format before they can add the item to the cart.

 

To enable Tone Preview  edit the settings in <tonepreview> tag.

 

<tonepreview enabled="Y">

<blackandwhite enabled="Y" />

<sepia enabled="Y" />

</tonepreview>

 

No PHP Imagemagick is used as in v3.0. The Tone filter is applied dynamically on the fly!  When the tone filter is enabled, buyer can continue to view other slides in that tone. The tone filter will only be reset when 'Reset' button is clicked in the tone preview window.

 

 

 

 

That's the end of customizing Shopping Cart feature!

 

 

How cart feature works:

 

1. Customer uses one of the checkout mode to place the order.
 

2. The order file is created in res/shoppingcart/ folder in the naming convention <YYYYMMDD_HHMMSS_sss>.txt using the current date and time (example: 20070822_211421231.txt). This file will contain the album url path, list of images bought, quantity, price, tax,shipping, buyer name, address details.

 

3. Checkouts:
 

Email Order:

a. When this checkout is used, FotoPlayer will create the order file and store it on res/shoppingcart folder.

b. The order file will be sent as an attachment to the buyer and optionally the buyer.

c. The buyer will be provided a link to the saved order file.

 

PayPal:

a. When the buyer uses paypal checkout, he'll be redirected to PayPal website on a popup page where they can directly pay using their credit card or use their paypal account to pay. FotoPlayer will send the order id and the total amount to be paid to PayPal.

b. The detailed order info with the list of images and other details will be notified by email to the seller and optionally to the buyer by FotoPlayer.

c. PayPal will send the payment confirmation to the seller and the buyer.

d. Seller has to take care of the order fulfillment manually

e. If you use FotoPlayer 'auto download' feature, the buyer will be redirected from paypal back to album where they can download the images themselves. FotoPlayer will also provide the originals in zip format. For more info, refer 'PayPal Auto Download' section of this user guide.

 

Google Checkout:

Similar to PayPal checkout. Currently there is no Auto Download feature available for this checkout.

 

CreditCard:

Allows you to use your custom payment gateway scripts to handle the credit card transaction. FotoPlayer scope ends with redirecting the buyer to a secured page on your site by passing as much as info from the cart. You can used the passed info from FotoPlayer and accept more info from the user if required and handle the transaction.

FotoPlayer will email notify the seller and buyer with the order info.

 

Offline order:

1. No email notification. FotoPlayer will display a popup page with the cart contents. The buyer can copy the contents or print and send the order by fax,mail or email manually. This checkout is designed for taking orders from CD albums.

 

4. Except when using PayPal auto download feature, the scope of FotoPlayer ends with taking the order. There is no order tracking process. It'll be up to the seller to decide how the order will be fulfilled (sending the images by post or email or providing download links)

 

 

 


FotoPlayer User Guide v1.5  

 Current page link: ShoppingCart Setup