Extension Demos

http://photocommerce.wmdextensions.com/

For the admin area, use
User: photo
Password: photo123
http://photocommerce.wmdextensions.com/admin

Installation

Follow the installation instructions on our Customer Service page.

The WMD Photo Commerce extension contains adminhtml template files.

  1. app/design/adminhtml/default/default/template/photocommerce

You might get some 'error 404' or similar in the admin area if you didn't log out from admin and then emptied var/cache and var/session after installation.

Slide Show Pro Director API users only

If you plan to generate products from folders with images, skip this section and contained steps. Continue with WMD Photo Commerce  How To(without API).

Thanks to SlideShowPro kindly allowing to pack the needed code into the extension, you can skip all the way to step 5. Text remains for displaying nicely how things work.

The WMD Photo Commerce extension contains some empty library folder called lib/Sspapi. If you want to use your Slide Show Pro Director API you have to download the files from your Slide Show Pro Account. Login at http://slideshowpro.net/account_center/member.php, on the PROFILE tab, click ACCESSORIES and download PHP API kit. After that, follow these steps

  1. Unzip the folder DirectorPHP_1.2.1.zip.
  2. Navigate to 'classes' folder, copy all files from in there to lib/Sspapi. *
  3. In lib/Sspapi, rename DirectorPHP.php to Director.php, then open the file in your text editor, IDE or other.
  4. On line #8, change 'class Director {' to 'class Sspapi_Director {'
  5. Login to admin, go to System/Configuration, click Photo Commerce in the CATALOG section to the lefthand side.
  6. Open the API Settings section, select Yes from Use SSP and fill in API Key** and Install Path*** in the fields showing up.
  7. Click Save Config.

* Remember you have to delete these files manually as well, after uninstall, before reinstall.
** API Key and *** Install Path you find in your own Slide Show Pro Director CMS. Sign in there and click System info at the top on the righthand side. Copy the values from the bottom of the list.

top

WMD Photo Commerce How To(with API)

Director
Start with making some new album or two, name them the same as the (sub)category will be called in your shop and put 3-5 Images in each album. Recommended size of images would be 1 size below the original, or in other terms the biggest size you plan to import through the API. Not sure about uploading some original files with 12 and more megabytes, try this yourself at your own risk, if you think it makes sense to you.

In case you crop the image preview, go through the images and define the focus point where needed.

Fill in Title and Caption fields if you want, leave empty for the extension to generate the product name from the filename(replacing _ and - by empty space).

In case of not being bothered to fill in image titles, make sure your image names make sense before uploading them to director. I suggest you use Rename-It to change your imagery names into something making sense with enumeration if you haven't done so allready.

Don't forget to activate your album in director, otherwise it will not be showing up in the album dropdown list we will use further down.

Magento Admin
In Catalog/Photo Commerce/Formats you see a list of sample formats. Copy the API sample formats sql dump here, if you need to restore them.

Assuming you test the sample formats, you need (S)FTP to create a folder called import in media and in import one called xl to have media/import/xl then upload all your original images into that folder.

Take care with image names again. They must be the same as those uploaded to director. In case director has renamed your files, putting _ for empty space etc. your original files have to be named the same. Otherwise the extension will disable the generated product and produce an error code displaying the product id from which the image(s) could not be found.

Now it's time to make some shop categories, if you haven't done so already. No problem if you want to make subcategories. You can name them the same as your album(s) in director, just to keep things simple.

In Catalog/Photo Commerce/Associated Albums, make sure you do not see the Scan Folder button at the top right. Otherwise go to step 5 in the Slide Show Pro Director API users only section above and enable the extension for ssp API as mentioned there.

Click New Association at the top right. The New Association screen should list your shop categories and subcategories and all albums in director being activated.Select the category and it's according album then click Continue to save the relation. Repeat the step for all relations. In case of to many images per (sub)category, you may prefer to do one category after the other. Thats no problem, do the first, delete it after product generation and make the next. In other terms: The association is not needed for the extension to work later. It is only a matter until you finish generating products from that album. You can even re create the association later, in case you have added images to the album.

Go back to director if your album is not in the list and activate it.

If you get an error from ssp director, reload the page. If the error remains the same, try finding out if the API is working as expected by uploading your DirectorPHP_1.2.1.zip original content and testing that as described here.

Click Generate Products to generate the products with their images and downloadable links.

The product generation opens in a new tab, doing one product after the other to make sure the servers script execution time is sufficient. At the start, some time is needed to grab the collection to generate. Keep this in mind, maybe process just a thousand at a time only instead of several thousand images.

In case of images not being found or not being available through director's API you will see the error in the rendering window, displaying the products ID and telling you that the product was disabled. Just go to Catalog/Manage Products, select Disabled from the Status column filter and hit enter to get all those products on the grid. Find out what differences there are in image names and eliminate them.

Go back to Catalog/Photo Commerce/Associated Albums and click Generate Products again. Existing images/products will be skipped, missing ones will be generated, if all differences in image names are eliminated and all images are uploaded to media/import/xl and to director album(s).

Then, go to your store's front end and check that the products are there and then test some of the downloads all the way through to downloading them from the customer account downloadable products page.

Keep reading after the "without API section". There is some interesting information about maintenance and configuration.

top

WMD Photo Commerce How To(from folders, without API)

Preparation
Go to Catalog/Photo Commerce/Formats and see the sample formats in the Format List. 7/8 should have a value in Local Storage Folder. Copy the Folder "sample formats sql dump" here to restore sample formats for product generation from folder images.

Assuming you use the sample formats, you need the 7 folders from the Format List in the Local Storage Folder column. Download the folders as a zip file here and unzip them to a convenient location.

Copy your original image files from 1 (sub)category in the photocommerce/xl folder. If you have Photoshop, download this photocommerce.atn Action if you want and load it. If you haven't got Photoshop, maybe have a look at IrfanView or use some Gimp Batch Processor to bulk resize your images.

Assuming you use Photoshop and want to use the provided sample action, rename the downloaded folder photocommerce to _photocommerce and move it to "C:\" to have "C:\_photocommerce" for the action to work. Back in Photoshop go to File/Automate/Batch. Select set photocommerce and action All formats. Source Folder you choose "C:\_photocommerce\xl", Destination Folder you choose "C:\_photocommerce\layout" and untick Override Action save as, then click ok. Photoshop should now export the needed formats to the coresponding folders in "C:\_photocommerce".

Now it's time to launch your favorite (S)FTP client and make some folder called "import" in "media" if you haven't done so before, to have "media/import". In the import folder, make a folder for each (sub)category you want to process in this step on this one level. Images imported to a subcategory will automatically be in parent categories, therefore it is sufficient to have the categories with no child categories to import from.

Upload all folders from "C:\_photocommerce" to the coresponding category folder you just made. Repeat the steps with the other categories you want to process, make categories in "media/import". It is easy to delete "C:\_photocommerce" and restart with unzipping the empty folders from photocommerce.zip. Just in case you forgot about such a simple thing, being in the middle of the learning process.

After uploading all the needed folders with images to your categories in "media/import/", go back to your shop's admin area.

In Catalog/Photo Commerce/Associated Albums you should see a Scan Folder button at the top right. If not, go to System/Configuration and click Photo Commerce from the CATALOG section. In the API Settings section, set Use SSP from 'Yes' to 'No', then click Save Config.

Click the Scan Folder button, the extension will confirm the scan and let you know how many images were found in total. Check for permissions if the scan is not working, even if files are in "media/import".

Now click New Association and select Category(which should be a (sub)category without child categories) from the first dropdown list, then select the coresponding Subfolder from the second drop down list, then click Continue.

Repeat these steps for all of the categories you made earlier, if you want. The association is not needed for the product to work, it can be deleted after product generation. It is no problem to add more images to a category by creating the relation again at a later point. You can also process one relation after the other, in particular if you have a lot of images for one category it will make sense to split the process. This is because things slow down with thousands of files in a folder. As you probably know, just to make sure this stays in your mind.

Click Generate Products for the extension to generate the products with all images and downloadable links. A new window opens called "Folder Image Product Generation Renderer", doing one product after the other to make sure the servers script execution time is sufficent. If there are images missing to generate a product, you should see an error letting you know which product id was affected, and that the product was saved as disabled. Then it is best to go into the disabled product, find out what's missing, then delete the product and re import the images.

Don't forget to click the Scan Folder button after changing the content in media/import. Even if you want to re import images that failed on generating products, or do one category after the other, or even just do parts of categories. You always have to Scan Folder for the extension to work.

top

WMD Photo Commerce Parse Metadata(from folders, without API)

You can set config to parse XMP or IPTC metadata from image files.

Select the format folder containing the metadata. Keep on mind that files will be opened to read that, selecting a small format for parsing metadata can save loads of memory.

Below the mapper, you find some input file to upload and analyze your metadata. After uploading a file, you find metadata from the sample to select and map to product attributes in the mapper.

On product generation all metadata will be inserted into product attributes as defined in the mapper.

top

WMD Photo Commerce Amazon S3 Storage(from folders, without API)

You can make the extension store your downloadable link files on Amazon s3 and it will automatically forward download requests with signed link to there for downloading.

For acces keys: Not to try with keys from initial setup. In the IAM Management Console, click your user name, then 'Security Credentials'. Do not start with IAM Users, click 'Continue to Security Credentials', then 'Access Keys'. Create Access Key and paste Key and Secret into config.

Click Services, S3 and create a bucket, paste name into config.

All downloadable link files will automatically be copied to the defined s3 bucket on product generation, using same folder structure as you have in import folder.

top

WMD Photo Commerce How To(with and without API)

Go to System/Configuration and click Photo Commerce from the CATALOG section.

In the General Settings section you can decide if you want  to automatically have the image dimensions in pixels, file size in kb/mb and mime type being added to the downloadable link title.

Abandoned Image Files
Go to System/Cache Management and click Flush Catalog Images Cache in the Additional Cache Management section to be prepared for the next step.

Go to Catalog/Photo Commerce/Abandoned Image Files and click New Abandoned Image File Search to scan your shop's media/product folder and compare the image list with all images being referenced in magento's database.

All image files from deleted products will appear in the list.

Select them all and remove them from your server by selecting Remove Image File from the Actions drop down list and clicking Submit.

Abandoned Link Files
Go to Catalog/Photo Commerce/Abandoned Link Files and click New Abandoned Link File Search to scan your shop's "media/downloadable/link" folder and compare the file list with all link files being referenced in magento's database.

All link files from deleted products will appear in the list.

Select them all and remove them from your server by selecting Remove Link File from the Actions drop down list and clicking Submit.

top

Remain prepared for things being updated and improved.

Feel free to put feature request and help improving things by giving feedback.

Simply click Contact and write your message.

 

top