Clone wiki

django-lfs / GettingStartedShop

  1. summary Getting Started: How to configure your first test shop and demonstrate basic shop functions#


You are not yet using the South migration software i.e. it is commented out of INSTALLED_APPS in


----------------------------------------------------------------------------------- Prerequisites

1. Have one or two sample product pictures ready to upload.

2. Edit lfs_project/ to amend your settings as required e.g. time zone, secret key, email parameters etc. If you are using a dummy email server for testing or demonstration then set EMAIL_HOST == "localhost" and EMAIL_PORT to the port on which the dummy email server is listening e.g. if using `python -m smtpd -n -c DebuggingServer localhost:1026` then set EMAIL_PORT == 1026

3. Edit one or more of the xml files in lfs_project/lfs/core/fixtures as required. For example copy and paste the countries the shop may sell to from lfs_all_countries.xml into lfs_initial.xml Eventually anything which is to be already set up prior to the demonstration to a potential customer can be put in an xml file so that some of the following steps may be omitted.

4. If you wish to start from scratch then delete or rename any existing lfs.db file in lfs_project and run python syncdb to create a fresh database.

5. Start the Django development server with: cd ……./lfs_project followed by python runserver (and your email server as appropriate). You may wish to put these commands in script(s) (or .bat file for Windows) for quick execution in future.

6. Apply one or more of the xml files as required e.g. python loaddata lfs/core/fixtures/lfs_initial.xml

Demonstration starts here

7. From login with the superuser you defined during the install.

8. From manage -> Shop -> Preferences -> Portlets -> Categories add a "Categories" portlet. Set any other shop preferences you wish. The reason for adding a ‘Categories’ portlet is because the categories are the navigation of the shop. You have to add a "categories" portlet to make them appear. Categories can display sub categories or assigned products. To make a product appear (within overviews) it has to have at least one category.

9. From manage -> Catalog -> Categories add a category e.g. “Birds”

10. From manage -> Catalog -> Products add a product e.g. “Parrot” (all you long time Python users may be guessing how this product will be reviewed later – patience please) and add an image, set stock quantities,price and anything else you want.

11. When you are happy with your product check the ‘active’ box on the product tab. (IF YOU FORGET THIS THE CUSTOMER WILL NOT BE ABLE TO SEE THE PRODUCT – WHICH COULD BE EMBARRASING IN THE MIDDLE OF A DEMO) and save it.

12. Logout

13. From login and register as a customer. If you get an error at this point check that your email settings are correct and your email server is started if appropriate. You should shortly receive a welcome email (if you are using the Python dummy mail server mentioned above it should appear on that screen as raw HTML).

14. You can now demonstrate basic shop features as seen by the buyer, although be sure to try the required checkout methods before your demonstration as further setup may be required. For example selecting Paypal as the checkout method will take you to the Paypal sandbox screen.

15. Rate the product and add a customer review: ‘Very Lively’

16. If you then logout from that user-id and login again as the shop manager you should now be able to see what the buyer has been up to, under ‘Customers’. In case you wish to try out further features here is some info about a few more functions:

Properties are used to create variants and/or product filters

As filters:

a. add a property: manage -> properties -> properties -> add property

b. add a property group: manage -> properties -> property groups -> add property

c. assign the property to the property group (via the property tab)

d. assign products to the property group (via the products tab)

e. assign values for the product/property combination

f. Add a "Filter" portlet: manage -> Shop -> Preferences -> Portlets

As base for variants

a. add a property: manage -> properties -> properties -> add property

b. add a property group: manage -> properties -> property groups -> add property

c. assign the property to the property group (via the property tab)

d. Go to the product and change it to "product with variants".

e. Go to the variants tab, add the relevant property group and click on add variants.

HTML pages are normal pages where you can add variable HTML

To make them appear you have to add a "Pages" portlet: manage -> Shop -> Preferences -> Portlets

Static blocks a blocks of HTML which can be assigned and displayed to a category

a. Add a static block

b. Go to a category and assign it

Static blocks may be removed from LFS in future in favor of a top slot for portlets.


Now return to step 3. and practice again whilst explaining LFS to a suitable stooge (wife, husband, cat, teddy bear?) until you are ready to go out and demonstrate LFS to a potential client. Good Luck.

Acknowledgements: Thanks to Kai Diefenbach for most of the information in this document.