User Tools

Site Tools


Sidebar

addons:storefront:start

This is an old revision of the document!


Storefront Addon

Steps to start using the Storefront:

To "turn it on" in the admin:

  1. In the admin, on Addons > Storefront Addon > Subscription Choices set up at least one subscription duration.
  2. In the admin, on Pricing > Price Plans Home Click the edit button for the price plan you want to enable storefronts for. Then click "cost specifics".
  3. Near the bottom of this page, in the section "Price Plan Items", click "configure" next to Storefront Subscription.
  4. Check the "enabled" box, then check the subscription periods you want to be available to the user to purchase a storefront subscription period.
  5. Click "save" button.

To "turn it on" for a user:

  1. Log in as the user.
  2. Go to My Account Information page.
  3. Near the bottom of this page, will be the Storefront section. If you do not see the storefront section, you may have not enabled the storefront for the "primary" price plan used by this user, see steps 2-5 above for turning it on in the admin.
  4. In the Storefront section, click the "renew your subscription" link, and follow the steps to purchase a storefront subscription.
  5. Once the subscription has been paid for and the order approved, go back to the my information page.
    • Tip: Check Orders > Manage Orders to make sure the order containing the subscription purchase is not pending, and check Orders > Manage Items for the pending subscription item if you have elected to make storefront subscription require admin approval.
  6. This time, near the top will be a link to the user's storefront URL.

Answers to Frequently Asked Questions

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:

  • BASIC PAGE TEMPLATE - 1 for the List Stores page
  • Storefront Default Template for the Home page
  • Basic Page Template with My Account Links for the Control Panel page

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, if you add more templates (via the Add New Template link on the admin's Templates Home page), and select for them to have the type 'Storefront,' 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:

  • {$storefront_logo} - shows this storefront's uploaded logo
  • {$storefront_homelink} - links to this storefront's home category
  • {$storefront_welcome_note} - shows the "welcome note" text for this storefront
  • {$storefront_categories} - array containing data for all the categories in this storefront
  • {$storefront_pages} - array containing data for all the "other pages" of this storefront

SEO Addon Connectivity

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:

  • Install or Upgrade to Storefront v1.7.5 as normal
  • In the admin, go to Addons > Storefront > Settings. Make sure the box for "Search Engine Friendly URL" is checked.
  • Regardless of whether it was already checked or not, save the form. This will let the SEO addon know there are new pages to look at.
  • In the admin, go to Addons > SEO > General Settings. Click on Apply All Settings, then Yes
  • Copy the updated contents that are then shown into your .htaccess file
addons/storefront/start.1270244891.txt.gz · Last modified: 2014/09/25 16:55 (external edit)