Commits

Chris Moffitt  committed 753921f

Added a tutorial based on #910

  • Participants
  • Parent commits 6894eb1

Comments (0)

Files changed (19)

File docs/images/add-options.png

Added
New image

File docs/images/admin-product-settings.png

Added
New image

File docs/images/adventurer-hat.png

Added
New image

File docs/images/adventurer_hat.png

Added
New image

File docs/images/category.png

Added
New image

File docs/images/create-config-product.png

Added
New image

File docs/images/option-group.png

Added
New image

File docs/images/options-completed.png

Added
New image

File docs/images/prod-description.png

Added
New image

File docs/images/prod-details.png

Added
New image

File docs/images/prod-price.png

Added
New image

File docs/images/product-add.png

Added
New image

File docs/images/product-select.png

Added
New image

File docs/images/save.png

Added
New image

File docs/images/select-config-product.png

Added
New image

File docs/images/subtypes.png

Added
New image

File docs/index.txt

    google-base
    upsell
 
-Depoloying A Store
-==================
+Tutorials
+=========
+.. toctree::
+   :maxdepth: 1
+    
+   tutorial1
+
+Deploying A Store
+=================
 
 .. toctree::
    :maxdepth: 1

File docs/product.txt

 Active
     This allows a category to be populated with information but to be set inactive.
 
-Active
 .. index::
    single: Product; fields
    
 A short tutorial
 ----------------
 
-Here is a quick step by step overview for adding something to your store.  Hopefully it illustrates how to add products and use the concepts described above.
-
- - From the admin interface, add a new individual Product
- - Choose the appropriate Category, Name, etc.  For illustration purposes, create a Satchmo Developer Book  
- - Be sure to put in a value for the price ($25.00) with no expiration or quantity.  Then click save
- - You should see a list of all your products
- - Click on the Satchmo Developer Book
- - At the bottom of your screen, you'll see the option to "Add ConfigurableProduct"  
- - Click on the link
- - Select the appropriate Option Group (Book Type) and click Save & Continue Editing
- - Check "Create Variations" and Click the save button
-
-You've now created all the Product Variants for the Satchmo Developer
-Handbook.  If you want to tweak specific ProductVariants you can but you
-don't have to. 
+For a more detailed tutorial that covers how to add a product, please review this :doc:`document <tutorial1>`. 
 
 The product variation manager contains a set of helper functions for managing product variations.
 It is accessed at /product/admin/variations/ and provides a streamlined process for managing all of 

File docs/tutorial1.txt

+Adding a Product to Your Store
+==============================
+
+This tutorial will walk through the typical process a store administrator
+will use to create a new product.
+
+For this example, we will be adding the following product to our store:
+
+.. image:: /images/adventurer_hat.png
+**Full Name:** Adventurer Hat
+
+**Description:**
+    This well made, extremely durable hat can be used in all sorts of conditions.
+    Whether you are a weekend adventurer or career explorer, you will be well
+    served by this product. It can keep you warm in the high mountains and keep
+    the sun at bay in the middle of the desert. Buy one today and start exploring!
+
+**Sizes:** Small, Medium, Large
+**Colors:** Black, Brown, White
+    
+**Price:** $49.95
+
+Steps
+-----
+
+Setup product types
++++++++++++++++++++
+
+Ensure the you have ``ConfigurableProducts`` and ``ProductVariations`` installed.
+Go to /settings and verify both values are highlighted in ``Product Model Options``:
+
+.. image:: /images/admin-product-settings.png
+
+
+Create the Product
+++++++++++++++++++
+
+From the main admin screen, under the Product section, click the "Add" icon next to "Products".
+
+.. image:: /images/product-add.png
+
+The main product screen will now be shown. There are multiple fields available to customize
+the product. We will fill in some of the most important.
+
+If you do not already have a "hats" category in place, create one by clicking on the green
+plus icon above categories. Once it is selected, you should see a screen like this:
+
+.. image:: /images/category.png
+
+Now, create the description for the product. The sku and slug fields can be left blank and will be
+automatically populated with values:
+
+.. image:: /images/prod-description.png
+
+Satchmo allows you to track inventory of your products, feature certain products and set whether or not
+the products are shippable. You may configure these items in the next section of the Product page.
+
+Additionally, you have the option to configure the Meta options (used for Search Engine Optimization), dimensions
+and tax properties. Depending on your product and store location you may or may not need to set these items. 
+For this example, we will use the default values.
+
+.. image:: /images/prod-details.png
+
+All products will need a price and an image. You can configure volume discounts if you like, but for this example,
+we will set the hat's price to $49.95. We will also upload the image.
+
+.. image:: /images/prod-price.png
+
+Once all off the product's information has been entered, you may save it.
+
+.. image:: /images/save.png
+
+At this point, you have created the Adventurer's hat but have not created the various size and color
+combinations you would like to offer. Instead of creating 9 new products (one for each combo), we can use
+Product Variations to make our lives a little bit easier.
+
+Create the Option Groups
+++++++++++++++++++++++++
+
+Going back to the main admin screen, click the "Add" Icon next to "Option Groups."
+
+.. image:: /images/product-add.png
+
+In the option group screen, we will set up our "Hat Size" option group. In this example, we
+configure the sizes so that a Large hat will be $2.00 extra.
+
+.. image:: /images/option-group.png
+
+After the values, are entered, click save.
+ 
+We will repeat the same process to create the hat colors options. Once they are both entered, you should see them
+in the admin interface.
+
+.. image:: /images/options-completed.png
+
+Create The Product Variations
++++++++++++++++++++++++++++++
+
+Now that we have our hat created and have the colors and sizes in place, we need to create hats
+with each color and size. To do this, we go back to our Product and configure it to use these options.
+
+From the main admin screen, click on "Products." You should have a list of all your store's products:
+
+.. image:: /images/product-select.png
+
+After displaying the Adventurer's Hat, scroll to the bottom of the page where you can configure the
+subtypes associated with the hat. Click on "Add Configurable Product":
+
+.. image:: /images/subtypes.png
+
+On the configurable product screen, highlight the "Hat Size" and "Hat Color" options and click "Save."
+
+.. image:: /images/add-options.png
+
+Select the "Adventurer Hat" configurable product:
+
+.. image:: /images/select-config-product.png
+
+From the screen, click on the "Create Variations" box and the click "Save" to associate the new variations 
+with the Product.
+
+.. image:: /images/create-config-product.png
+
+You have now created all 9 variations of this product!
+
+View the Final Product
+++++++++++++++++++++++
+
+You can view your final product here - /product/adventure-hat/
+
+In this example, note how the price automatically changes based on the options selected.
+
+.. image:: /images/adventurer-hat.png
+