NavigateTomorrow
Prepared for Mars Hill Productions
Site editor guide · The HOPE store
STEP-BY-STEP MANUAL

Adding a new language version to The HOPE store

Every step, from creating the download products and uploading files to publishing the store page and testing a real download.

Overview

This manual covers every step of adding a new language version of The HOPE to the store:

  • three video downloads: high, medium and low quality MP4
  • two study guide PDFs
  • the store page that ties them together, including its thumbnail

A working demo, The US English HOPE (DEMO), was built on staging by following these exact steps. Open it next to this manual:

Delete the demo after training. See Removing the demo.

The one rule: one product per file

Every file someone can download is its own product, with exactly one variation.

For a typical language, that's five products:

ProductIconIts one variation holds
High Quality MP4 DownloadHQMP4SKU, $7.00, the HQ MP4 file
Medium Quality MP4 DownloadMQMP4SKU, $5.00, the MQ MP4 file
Low Quality MP4 DownloadLQMP4SKU, $0.00, the LQ MP4 file
Study Guide – Digital PDFStudy GuideSKU, $0.00, the first PDF
Study Guide – Print-ready PDFStudy GuideSKU, $0.00, the second PDF

Why: the store page builds each row from a product. It takes the label and icon from the product, and the Add to cart button always adds that product's first variation. If you put three files under one product, all three rows look identical and every button adds the HQ download, even on the $0 row.

On top of the five products you make one Product Group: the page visitors see. It links to all five products and holds the thumbnail.

Video products Study guide products Product Group Check

Work in this order: products first, then the Product Group. The Product Group links to the products by name, so they have to exist first.

You don't need to add anything to the store overview pages (/the-hope/store/the-hope/grid and /list). A published Product Group shows up on both automatically, in alphabetical order.

Before you start

Gather these:

  • Three video files: high, medium and low quality MP4.
  • Two study guide PDFs.
  • A thumbnail image, 1920×1080, PNG or JPG.
  • The adaptation ID for the language. This number goes into the SKUs and onto the Product Group. The demo uses 999.
  • The details: language, countries, region, runtime, technical specs, and a short description.

About large files: each upload can be up to 3.91 GB, and a full movie can take several minutes. Leave the page alone until the file name appears under the upload box. If you click Save before then, the file is lost.

Create the three video products

Do all of 1a and 1b once for each quality: HQ, then MQ, then LQ.

1aThe product

  1. Go to Commerce → Products → Add product, then choose Product (/product/add/product).
  2. Fill in:
    FieldHigh qualityMedium qualityLow quality
    TitleThe US English HOPE – High Quality MP4 DownloadThe US English HOPE – Medium Quality MP4 DownloadThe US English HOPE – Low Quality MP4 Download
    IconHQMP4MQMP4LQMP4
    View Display Name (the label on the store page)High Quality MP4 DownloadMedium Quality MP4 DownloadLow Quality MP4 Download

    Leave Published checked. Leave Body, Group Item Title, Group Item Sub-title, Image and URL alias empty.

    Double-check the Icon. When you're adding several products in a row, it's easy to leave the previous one selected.

  3. Click Save and add variations at the bottom. Don't click plain Save. You land on the product's Variations tab, which is empty for now.

1bThe product's one variation

  1. Click Add variation.
  2. Fill in:
    FieldHigh qualityMedium qualityLow quality
    TitleSame as the product titleSame as the product titleSame as the product title
    SKUTH-FLST-999-HQMP4-1TH-FLST-999-MQMP4-1TH-FLST-999-LQMP4-1
    Price7.005.000.00

    Leave Provide a list price unchecked.

  3. Upload the file:
    1. Under File(s) → Add a new file, click Choose file and pick the matching MP4.
    2. The upload starts on its own. Wait until the file name and size appear with a Remove button next to them.
  4. License Type: leave it set to File.
  5. License Expiration: change it to Unlimited.

    The default is Interval based on reference date. If you leave that, customers' download access expires. Always switch it to Unlimited. The extra date fields disappear once you do.

  6. Leave Limit the number of times a user can download unchecked, unless Mars Hill wants a limit for this file.
  7. Leave Published checked and click Save.

Don't click Add variation a second time. Each product gets exactly one variation. For the next quality, go back to 1a and start a new product.

When you're done, you have three products. Each one's Variations tab shows one row with its SKU, price and "Published".

SKU pattern: TH-FL + ST (on-screen storyteller) or VO (voice only) + - + adaptation ID + - + format + -1. SKUs must be unique across the whole store.

Create the two study guide products

Do this once for each PDF.

2aThe product

  1. Go to Commerce → Products → Add product → Product.
  2. Fill in:
    FieldDigital PDFPrint-ready PDF
    Title (the label on the store page)The HOPE Study Guide (US English) – Digital PDFThe HOPE Study Guide (US English) – Print-ready PDF
    IconStudy GuideStudy Guide
    Group Item TitleSame as the titleSame as the title
    Group Item Sub-title65 Lessons (5 per video chapter), Additional ResourcesSame

    For study guides, the store page shows the product Title, so make it clear and customer-friendly.

  3. Click Save and add variations.

2bThe product's one variation

The steps are the same as 1b:

FieldDigital PDFPrint-ready PDF
TitleSame as the product titleSame as the product title
SKUTH-999-SGMH-1TH-999-SGMH-2
Price0.000.00
FileUpload the first PDFUpload the second PDF
License TypeFileFile
License ExpirationUnlimitedUnlimited
SKU pattern: TH- + adaptation ID + -SGMH- + number.

Create the Product Group (the store page)

  1. Go to Content → Add content → Product Group (/node/add/product_group).
  2. Fill in, from top to bottom:
    FieldEnterDemo value
    TitleThe name visitors see. It also decides the alphabetical position on the overview.The US English HOPE
    Product Group Media ImageSee adding the thumbnail below.The 1920×1080 thumbnail
    Exclude from ListsLeave unchecked so the page shows on the store overview. Tick it to hide the page from the overview (see Hiding a version).Unchecked
    Adaptation IDThe language's number999
    LanguagePick oneEnglish
    ContinentsPick one or more (Cmd-click on Mac or Ctrl-click on Windows to pick several)North America
    CountriesPick one or moreUnited States of America (the)
    LocationPick one or moreNorth America
    The HOPE Version/TypeOn-screen or off-screen storytellersFull Length-Original/On Screen Storytellers
    Total RuntimeFree text80 Minutes
    Technical SpecsPick oneHD, NTSC, 16:9 aspect ratio, Stereo sound, Color
    DescriptionA short paragraph about this version
    OtherOptional. A Product Resource such as a video stream
    DVDOnly if there's a DVD product
    Study GuideBoth study guide products, one per boxDigital PDF, then Print-ready PDF
    Full Movie DownloadsAll three video products, one per boxHQ, then MQ, then LQ

    To add the Product Group Media Image:

    1. Click Add media. A pop-up opens on the media library.
    2. At the top of the pop-up, click Choose file and pick the thumbnail. (If it was uploaded before, search for it below and tick it instead, then skip to step 5.)
    3. Fill in Alternative text, for example The US English HOPE thumbnail.
    4. Click Save. The new image is now ticked.
    5. Click Insert selected. The thumbnail now shows in the form.

    To link several products in Full Movie Downloads or Study Guide:

    1. In the first box, type part of the product's title, wait for the suggestion list, and click the right one. The box then shows the title with a number in brackets, like (1622). If the number is missing, Drupal didn't match a product.
    2. Click Add another item under the field. A new empty box appears.
    3. Repeat for each product.
    4. The order of the boxes is the order on the page. Drag the ✥ handles to reorder them.
    5. Empty extra boxes are ignored when you save.
  3. Check the settings in the right-hand sidebar:
    • URL alias: leave Generate automatic URL alias checked. The page address is built from the title. The demo got /the-hope/store/us-english-hope-demo.
    • Promotion options: Promoted to front page is checked by default. Uncheck it.
    • Published: checked.
  4. Click Save.

Check your work

  1. The store page opens right after saving. Check:
    • The thumbnail, language, location, version, runtime, specs and description are all correct.
    • Full Movie Downloads shows three rows, each with its own icon and label: High Quality MP4 Download for $7.00, Medium Quality MP4 Download for $5.00, and Low Quality MP4 Download for $0.00.
    • Study Guides shows two rows, one for each PDF.
    • Every row has an Add to cart button.
  2. The overview: open /the-hope/store/the-hope/grid. The new version shows in alphabetical order with its thumbnail. Switch to List, and it shows under its first letter.
  3. Search: type the language into the store search box. The search matches the title, language, countries, continents and location.
  4. A real download:
    1. Add the free LQ item to the cart and click Checkout.
    2. On Order information, confirm the billing address and click Continue to review.
    3. On Review, pick a Country, tick Terms and Conditions, and click Complete checkout.
    4. Open My account → Files. The file should be listed with Downloads "Unlimited" and Expires "Never", and clicking it should download the right file.

    This confirms the file and license are set up right.

If the page doesn't appear on the overview, make sure it's Published, then go to Configuration → Performance → Clear all caches.

Troubleshooting

The upload just keeps spinning.
Large MP4s take a while. Leave the tab open. If it times out, ask the host to raise PHP's upload time limits.
Two rows on the store page look the same, or Add to cart adds the wrong item.
A product has more than one variation. Open the product's Variations tab. If there's more than one row, delete the extra one, make it its own product (Step 1), and add that product to the Product Group.
A product doesn't come up in the Product Group's autocomplete.
Make sure the product is saved and Published. Type a distinctive part of its title.
"The SKU is already in use."
SKUs must be unique. Check that you typed the right adaptation ID and format.
Customers lose access to a download.
The variation's License Expiration was left on Interval based on reference date. Edit the variation, set it to Unlimited, and save.

Hiding a version from the overview pages

To keep a store page live but leave it off the overview pages (grid, list and search), tick Exclude from Lists on the Product Group and save. Untick it to bring the page back. The page itself stays published, so direct links to it keep working.

"The HOPE – For Live Performance" and "The Life DVD Series" are hidden this way.

Unpublishing a Product Group also removes it from the overview, but it makes the page itself unavailable too. Use the checkbox when you only want it off the lists.

Removing the demo

When training is done, delete these items:

  1. The store page: Content, find The US English HOPE (DEMO), then Delete.
  2. The five demo products: Commerce → Products, search for (DEMO), then Delete each one: HQ, MQ, LQ, Digital PDF and Print-ready PDF. Their variations go with them.
  3. The thumbnail: Content → Media, find us-english-hope-thumbnail-demo.png, then Delete.

Quick checklist

0 / 9