| Register
Friday, May 09, 2008
ReadyShop documentation
 Disclaimer:

All the following information is provided to be helpful. None of it is guaranteed to be correct either at the time of writing or reading. You use this software at your own risk.

Introduction

Installation

How to use ReadyShop  

Introduction
Installation

PIL (Python Imaging Library)

To resize images this package relies on the Python Imaging Library (PIL). This component is free and can be found at http://www.pythonware.com .

The following is the procedure that I found worked when I was installing PIL on Linux, Fedora core 3 and core 4 (test 2).

JPEGlib

To create the jpeglib (which is required by PIL if you want to resize JPEG images):

  1. Get a copy of the jpeg-lib from the Independent JPEG Group at http://www.ijg.org/ . The file you need should be called something like jpegsrc.v6b.tar.gz .
  2. Unzip the file into a folder, drop into the folder, and run ./configure
  3. Now run make
  4. Place libjpeg.a into /usr/lib

libImaging

  1. Get a copy of the PIL source from http://www.pythonware.com  (it should be called something like Imaging-version)
  2. Run python setup.py build

    --------------------------------------------------------------------
    PIL 1.1.5 BUILD SUMMARY
    --------------------------------------------------------------------
    version 1.1.5
    platform linux2 2.3.4 (#1, Feb 2 2005, 12:11:53) 
                          [GCC 3.4.2 20041017 (Red Hat 3.4.2-6.fc3)]
    --------------------------------------------------------------------
    *** TKINTER support not available
    --- JPEG support ok
    --- ZLIB (PNG/ZIP) support ok
    --- FREETYPE2 support ok
    --------------------------------------------------------------------

  3. Run python selftest.py (it should respond - 55 tests passed - or something similar)
  4. Run python setup.py install
  5. Check that _imaging.so has been installed into the correct Python directory #

# In my case the _imaging.so library had been installed into /usr/lib/python2.3/site-packages/PIL and actually needed to be in /home/zope/Zope/lib/Python so that my Zope server could use it.

Having completed the steps above you should now have fully a functional Image resizing library to use with ReadyShop.

ImageTag_CorePatch

PLEASE NOTE:  There is a bug somewhere that stops the standard pil_tag command from working. If you don't install this Product you will receive the following warning when you try to resize images: "Attribute Error: pil_tag"

MySQLdb

This product requires the MySQLdb product from http://sourceforge.net/projects/mysql-python

Archetypes

ReadyShop is built using the Archetypes package. The archetypes product can be found at: http://plone.org/documentation/archetypes/download

ReadyShop

The installation is achieved by unzipping the ReadyShop,OxiDatabase and OxiLogger products into the following directories.

  • The contents of /ReadyShopProducts/ into ploneinstance/Data/Products/
    (note ImageTag_CorePatch is included here but you may wish to use a more recent version)

  • The contents of /ReadyExtensions/ into ploneinstance/Data/Extensions/

You will also need to run the provided MySQL SQL script in ReadyShopMySQLscripts to set up the database, and configure the OxiDatabase product to allow access to the MySQL database.

Now go into ploneinstance/Data/Products/ReadyShop/ and setup config.py so that it contains the correct hostname, user and password for accessing the database you have just set up.

Restart Zope and go to archetype_tools in the plone instance in which you want to use ReadyShop.

Install everything beginning with "ReadyShop_".

Registering objects

Some objects need to be registered to allow ReadyShop to access it's methods. These objects can be imported into your plone instance using the ReadyShop_items.zexp file provided in the zip file. Once imported the files should be moved into your portal_skins/custom directory.

Now you're ready to start using ReadyShop. Enjoy!!!

How to use ReadyShop
Company Number: 4877952 | Copyright © 2007 Oxinet Ltd.   |  Privacy Statement  |  Terms Of Use