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:
| Product | Icon | Its one variation holds |
|---|---|---|
| High Quality MP4 Download | HQMP4 | SKU, $7.00, the HQ MP4 file |
| Medium Quality MP4 Download | MQMP4 | SKU, $5.00, the MQ MP4 file |
| Low Quality MP4 Download | LQMP4 | SKU, $0.00, the LQ MP4 file |
| Study Guide – Digital PDF | Study Guide | SKU, $0.00, the first PDF |
| Study Guide – Print-ready PDF | Study Guide | SKU, $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.
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
- Go to Commerce → Products → Add product, then choose Product (
/product/add/product). - Fill in:
Field High quality Medium quality Low quality Title The US English HOPE – High Quality MP4 Download The US English HOPE – Medium Quality MP4 Download The US English HOPE – Low Quality MP4 Download Icon HQMP4 MQMP4 LQMP4 View Display Name (the label on the store page) High Quality MP4 Download Medium Quality MP4 Download Low 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.
- 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
- Click Add variation.
- Fill in:
Field High quality Medium quality Low quality Title Same as the product title Same as the product title Same as the product title SKU TH-FLST-999-HQMP4-1TH-FLST-999-MQMP4-1TH-FLST-999-LQMP4-1Price 7.00 5.00 0.00 Leave Provide a list price unchecked.
- Upload the file:
- Under File(s) → Add a new file, click Choose file and pick the matching MP4.
- The upload starts on its own. Wait until the file name and size appear with a Remove button next to them.
- License Type: leave it set to File.
- 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.
- Leave Limit the number of times a user can download unchecked, unless Mars Hill wants a limit for this file.
- 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".
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
- Go to Commerce → Products → Add product → Product.
- Fill in:
Field Digital PDF Print-ready PDF Title (the label on the store page) The HOPE Study Guide (US English) – Digital PDF The HOPE Study Guide (US English) – Print-ready PDF Icon Study Guide Study Guide Group Item Title Same as the title Same as the title Group Item Sub-title 65 Lessons (5 per video chapter), Additional Resources Same For study guides, the store page shows the product Title, so make it clear and customer-friendly.
- Click Save and add variations.
2bThe product's one variation
The steps are the same as 1b:
| Field | Digital PDF | Print-ready PDF |
|---|---|---|
| Title | Same as the product title | Same as the product title |
| SKU | TH-999-SGMH-1 | TH-999-SGMH-2 |
| Price | 0.00 | 0.00 |
| File | Upload the first PDF | Upload the second PDF |
| License Type | File | File |
| License Expiration | Unlimited | Unlimited |
TH- + adaptation ID + -SGMH- + number.Create the Product Group (the store page)
- Go to Content → Add content → Product Group (
/node/add/product_group). - Fill in, from top to bottom:
Field Enter Demo value Title The name visitors see. It also decides the alphabetical position on the overview. The US English HOPE Product Group Media Image See adding the thumbnail below. The 1920×1080 thumbnail Exclude from Lists Leave unchecked so the page shows on the store overview. Tick it to hide the page from the overview (see Hiding a version). Unchecked Adaptation ID The language's number 999 Language Pick one English Continents Pick one or more (Cmd-click on Mac or Ctrl-click on Windows to pick several) North America Countries Pick one or more United States of America (the) Location Pick one or more North America The HOPE Version/Type On-screen or off-screen storytellers Full Length-Original/On Screen Storytellers Total Runtime Free text 80 Minutes Technical Specs Pick one HD, NTSC, 16:9 aspect ratio, Stereo sound, Color Description A short paragraph about this version Other Optional. A Product Resource such as a video stream DVD Only if there's a DVD product Study Guide Both study guide products, one per box Digital PDF, then Print-ready PDF Full Movie Downloads All three video products, one per box HQ, then MQ, then LQ To add the Product Group Media Image:
- Click Add media. A pop-up opens on the media library.
- 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.)
- Fill in Alternative text, for example The US English HOPE thumbnail.
- Click Save. The new image is now ticked.
- Click Insert selected. The thumbnail now shows in the form.
To link several products in Full Movie Downloads or Study Guide:
- 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.
- Click Add another item under the field. A new empty box appears.
- Repeat for each product.
- The order of the boxes is the order on the page. Drag the ✥ handles to reorder them.
- Empty extra boxes are ignored when you save.
- 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.
- URL alias: leave Generate automatic URL alias checked. The page address is built from the title. The demo got
- Click Save.
Check your work
- 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.
- 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. - Search: type the language into the store search box. The search matches the title, language, countries, continents and location.
- A real download:
- Add the free LQ item to the cart and click Checkout.
- On Order information, confirm the billing address and click Continue to review.
- On Review, pick a Country, tick Terms and Conditions, and click Complete checkout.
- 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:
- The store page: Content, find The US English HOPE (DEMO), then Delete.
- 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.
- The thumbnail: Content → Media, find us-english-hope-thumbnail-demo.png, then Delete.