Skip to main content

Tab 3: Digital & Article Linking Configuration

Basic: 1 Digital File per Product Standard: Unlimited Files & Downloads Pro: Expiring Tokens & Encrypted Downloads Ultimate: Enterprise Cloud Storage

The Digital & Article Linking tab (#digital) connects electronic assets (software archives, e-books, MP3 audio, PDF guides, license packages) to products and establishes native relationships with Joomla Content Articles.

1. Overview​

From the Digital & Article Linking tab, store administrators configure:

  • Encrypted Digital Asset Assignment: Attach files stored in secure server directories to product records.
  • Download Token Expiration: Set maximum validity periods (e.g., 30 days) for time-limited digital access.
  • Download Attempt Limits: Enforce maximum download counts per purchase to prevent unauthorized link sharing.
  • Joomla Content Article Linking: Link any published Joomla Article to render comprehensive manuals or technical specifications directly within the product layout.

2. Before You Start​

  • Upload Files: Place digital asset packages (.zip, .pdf, .mp3, .tar.gz) into the protected storage directory (/media/com_flexext_store/downloads/ or /storage/download/).
  • Product Type: Set Product Type to Digital in the General Info tab.

3. Where to Find It​

  1. Open the Product Editor (index.php?option=com_flexext_store&view=product&layout=edit&id=1).
  2. Click the third tab in the navigation bar: Digital & Article Linking (#digital-tab).
Documentation screenshot
Figure 6: Digital & Article Linking configuration workspace with secure file download attachments, token limits, expiry windows, and article embedding.
Interface Guide & Numbered Badges
  • Badge 1 — Digital & Article Linking Tab: Activates electronic delivery assets and Joomla article linking settings.
  • Badge 2 — Digital Download File Association: Selects the protected asset archive, download count limits, and token validity windows.
  • Badge 3 — Joomla Content Article Integration: Links a native Joomla CMS article to render full technical manuals directly in the product layout.

4. Step-by-Step Configuration​

1

Selecting a Digital Download Asset

In the Digital Download File dropdown (select[name="digital_file"]), choose the pre-uploaded archive from the list of available files. You should see: File size and checksum information are automatically verified.

2

Setting Download Constraints

Configure download governance rules:

  • Download Limit: Enter maximum allowed downloads per license (e.g., 5). Set to 0 for unlimited.
  • Token Expiry (Days): Enter number of days download links remain valid (e.g., 365). Set to 0 for lifetime access. You should see: Download links generated upon purchase will enforce these cryptographic token constraints.
3

Linking a Joomla Content Article

In the Associated Joomla Article dropdown (select[name="article_id"]), select an existing article from com_content. You should see: The full rendered content of that article will automatically embed into a dedicated "Documentation" or "User Guide" tab on the storefront.

4

Saving the Configuration

Click Save in the top action bar. You should see: The product is now configured for automated instant post-purchase delivery.

5. Field Reference​

FieldDescriptionDefaultNotes & LimitsEdition
Digital Download FileAssociated download package archiveNoneBasic: 1 file; Pro/Ultimate: unlimited Basic / Pro
Download LimitMax download attempts per order0 (Unlimited)Blocks download once limit reachedBasic
Token Expiry DaysNumber of days link remains active0 (Lifetime)Returns 403 Forbidden after expiryBasic
Associated ArticleJoomla content article (com_content)NoneEmbeds article body into productBasic

6. Storefront & Customer Delivery​

When a customer purchases a digital product:

  1. Upon payment confirmation (e.g. Stripe, PayPal, or admin approval), a unique cryptographically signed download token is generated.
  2. The customer receives an automated order email containing a secure download button.
  3. The customer can access and re-download the file at any time from their My Account ➔ Downloads & Licenses portal on the storefront.
  4. Direct web access to the raw file path is blocked by .htaccess / Nginx server directives; all files stream exclusively through the secure OpenCart/Joomla download controller.

7. Tips & Best Practices​

Centralized Documentation via Articles

Instead of maintaining separate product manuals, write them as standard Joomla Articles. When linked to a product, any updates to the Joomla Article immediately reflect on the product page without having to re-edit the product.

Webroot Ban for Download Files

Never upload commercial digital download packages directly into public webroot directories (e.g. /images/ or public HTML folders). Always store them in the designated protected storage directory to prevent unauthorized hotlinking.

8. Troubleshooting​

SymptomProbable CauseRecommended Resolution
Customer receives "Download Token Expired" errorThe configured Token Expiry Days period has elapsedIn Order Details, administrator can generate a fresh token or reset the expiry date.
Customer reaches download limit unexpectedlyBrowser download managers opened multiple simultaneous connectionsIncrease Download Limit or reset download counter in customer order view.
Digital file dropdown is emptyNo files exist in /media/com_flexext_store/downloads/Upload .zip or .pdf archives to the downloads directory.