This is an old revision of the document!
Steps to start using the Storefront:
To "turn it on" in the admin:
To "turn it on" for a user:
Q: My storefront pages are missing decorations, or I see lots of (!TAGS!) everywhere. How can I fix this?
A: Most likely, you need to assign templates to the storefront pages. In your Admin panel, go to Addons > Manage Addons. Find the row labeled Storefront and click the link on that row labeled Edit Page. From here, select the templates to use, and save the form. One more thing to note is that the HOME page requires a Storefront-specific template be assigned to it for everything to look right.
Q: Why does the Storefront Control Panel show only a blank page?
A: Usually, this happens because the Control Panel page is missing a template assignment. Follow the instructions in the last answer to assign a template to the Control Panel page.
Q: What templates should I assign by default?
A: Assuming the rest of your site uses the default design, you'll want to use:
Note: these values provide a good starting place, but you may need to modify them to fit the customized design of your specific site.
Q: Why doesn't the left column of links appear on my storefront page?
A: The left-hand links are dynamically not shown if they have no content to display. If you add a Page or Category through the Storefront Manager, the menu will appear as expected.
Q: A specific user's store is not showing up in the List Stores page. What gives?
A: Be sure the user in question has turned on his/her individual store, using the directions given above under To "turn it on" for a user
Q: What is a "Trial Period?"
A: A Storefront Subscription period that is marked as "Trial" can be used only once per user, then that user can no longer purchase a subscription for that period. For instance, if you wanted to offer a free month of Storefront for new users, but then wanted them to pay a monthly fee for storefront access, you could set up two 30-day Storefront Subscription periods: one with a cost of $0 and the Trial box checked, and another with your monthly cost and no trial.
Q: Why can't I purchase a storefront subscription from the cart?
A: Most likely, you haven't finished attaching subscription periods to your user's price plan. Make sure to carefully follow the directions given above under To "turn it on" in the Admin, particularly steps 3-5
Q: How do I edit the text of the storefront shown on the client side?
A: In the admin tool, go to ADDONS > MANAGE ADDONS. Find the Storefront row, which should have a link that says Edit Text that will take you to a page from which you can translate text relating specifically to the Storefront addon.
Q: Can I allow users to choose between multiple storefront designs?
A: Yes (if using an Enterprise-level product). When you first install the Storefront addon, there is only one, default, Storefront template included. However, more can be added. Create new template files, and then attach them to the "User Storefront Pages" page in the admin, by going to Addons > Storefront > Edit Pages, selecting the Edit button next to "User Storefront Pages," and adding your Additional Template Choices in the form provided. Once that is done, those templates will appear as selectable options in every store owner's Storefront Control Panel. The "Template Selection" dropdown does not appear unless there are multiple templates for the user to select between, so if you don't see it right away, you probably only have one Storefront template. Keep in mind, also, that only the Enterprise editions of the software are able to create new templates, so if using Basic or Premier, you will be limited to only the single Storefront Template.
Q: What tags can I use in my Storefront Templates?
A: The best thing to do is look at the default storefront template to see how these tags are used, but they're listed here, for reference:
In Storefront version 1.7.5 (released concurrently with Geo 5.0.2), we added some more storefront pages to the SEO addon. If you're using these two addons together, you can follow the following steps to enable rewriting of these pages: