Skip to content

Install On Store

Use the following steps to add Genesis to onto a Miva Store.

Download Assets

Download & extract genesis-install.zip then proceed with the following changes within your Miva admin.

1. Install The Miva Modules onto Your Store

Note

If you need a store to experiment with, go to docs.miva.com/developers, click on the "Sandbox Store" link, and submit the form. A store should be created for you in a couple hours/days.

  1. Login into the Miva Store and navigate to Settings > Domain Settings > Modules
  2. Click the following series of buttons: Add Module > Upload > Choose File
  3. Pick one of the .mvc files (ry_toolbelt.mvc, mvps-placeholders.mvc, transients.mvc, tgcomponents.mvc)
  4. Click the "Upload" button and then the "Add" button.
  5. Repeat steps 2-4 for each of the .mvc files until they are all installed
  6. Navigate to Utility Settings > Add/Remove Modules and click the "Install" button for the following modules
    1. Standard Facets
    2. Template Search & Replace
    3. Transients
    4. Basket Inventory
    5. Order History Notes
    6. Product Image Custom Fields
    7. Review Baskets
  7. Ensure you have at least on Shipping Module/Method & Payment Module/Method activated.

2. Add the placeholders Item

  1. Navigate to User Interface > Items > Add Item
    1. Set the Code: to placeholders
    2. Set the Module: to mvps_placeholders
  2. Click the "Add" button
  3. Navigate to the placeholders item's Pages tab (Template > Items Edit Item: Placeholders > Pages) and assign it to all the pages you will use it on.

3. Install config files

  1. Navigate to Settings > Data Management > Import Data & Settings in XML Provisioning Format.
  2. Upload all the .xml files in this order:
    1. provisioning-import.xml
    2. components_layouts--components.xml
    3. components_layouts--layouts.xml

4. Install framework pkg file

  1. Navigate to User Interface > Frameworks > Upload Framework > Upload - Overwrite
  2. Upload the genesis--vX.X.X.pkg file
    1. You can get this pkg file from the genesis-install.zip or from the Genesis CLI
  3. Check the row with the Code: "genesis--vX.X.X"
  4. Click the "Apply Framework" button
  5. Check the "Overwrite CSS Resources, JavaScript Resources, and Other Resources" checkbox
  6. Click the "Apply" button and then click the "Apply" button again on the next confirmation page.

5. Post Install Verifications

  1. After applying the Genesis framework, confirm the following:
    • Order Fulfillment Settings > Template Based Emails
      • The Create Customer Account template based email was created.
      • The Customer Password Reset template based email was created.
      • The Updated Password Notification template based email was created.
    • Marketing > Feeds
      • The Product Schema feed was created.
    • Store Settings > Scheduled Tasks
      • The Update Product Schema Data scheduled task was created and is set to run the Product Schema marketing feed.
    • Custom Fields
      • The custom fields and custom field groups listed in the provisioning-import.xml file have been created.
      • The Product Schema Data product custom field is selected in the custom fields box on the PROD page.
    • Customers > Customer Settings
      • The Password Reset Style should be set to "Require Password Change" This setting is required when you are using the new customer password reset and update workflow.

6. Additional Store Settings

  1. Consider changing the Store's currency-module to the Generic Currency Conversion module & settings described here
  2. Consider changing the Store's URI Management to URI Management Settings depicted here
  3. Set the Store's > Store Settings > Character Set to utf-8
  4. Double check the values defined in the following templates to ensure they are using appropriate variables and values for the store (ex. LocalBusiness, brand, mpn, sku, etc.)
    • User Interface > CSS/JavaScript Resources > JavaScript Resources > json_ld
    • User Interface > Theme Components > Content Sections > product_schema_iterator
  5. Optionally, (but recommended) enable the Redis Cache Configuration
  6. Review the page-item assignments of the store (especially high-traffic pages like SFNT, CTGY, PROD, BASK, etc.) and ensure the previous frameworks problematic items (ex category_tree) have been unassigned.
  7. Review the optional modifications and apply them to your setup as you see fit