Content - EDocman Document Plugin

Overview

The Content - EDocman Document plugin enables displaying complete document details within Joomla articles using shortcodes.

Plugin Group: content
Purpose: Embed document information and details directly in article content
Syntax: {edocmandocument ID} where ID is the document ID

Configuration

No configurable parameters - plugin automatically processes shortcodes.

How It Works

  1. Insert shortcode in article content: {edocmandocument 25}
  2. Plugin detects shortcode during article rendering
  3. Retrieves document details from database (ID 25)
  4. Replaces shortcode with formatted document display:
    • Document title
    • Thumbnail image
    • Description
    • Download button
    • File information (size, type)
    • Metadata (category, tags, etc.)
  5. Respects document permissions (hidden if user lacks access)

Features

  • Full Document Display: Complete document card/panel in articles
  • Permission-Aware: Respects document access levels
  • Automatic Updates: Changes to document reflect automatically in article
  • Layout Integration: Uses component layout styling
  • Multiple Embeds: Include multiple documents in single article

Usage

Enable Plugin

  1. Navigate to Extensions → Plugins in Joomla admin
  2. Search for "Content - EDocman Document"
  3. Enable the plugin
  4. Save

Insert Shortcode in Article

Method 1: Manual Entry

  1. Edit article in Joomla
  2. Insert shortcode: {edocmandocument 25}
  3. Replace "25" with actual document ID
  4. Save article

Method 2: Using Editor Button Use the "EDocman Document Shortcode" editor button (editors-xtd plugin) to insert shortcode via modal selection.

Find Document ID

  1. Go to Components → EDocman → Documents
  2. Note the ID column for desired document
  3. Use this ID in shortcode

Syntax Examples

Single Document:

{edocmandocument 42}

Multiple Documents:

Check out these resources:

{edocmandocument 15}

{edocmandocument 23}

{edocmandocument 31}

In Article Content:

<p>Here is our product manual:</p>

{edocmandocument 101}

<p>For technical specifications, see:</p>

{edocmandocument 102}

Display Output

When rendered, shortcode displays document with:

  • Document thumbnail (if available)
  • Document title (linked to details page)
  • Short description
  • File information (type, size)
  • Download button
  • View button (if enabled)
  • Category badge
  • Tags (if configured)

Output styling matches component theme settings.

Use Cases

  • Tutorial Articles: Embed downloadable files within tutorial content
  • Product Pages: Include product documentation in product articles
  • Resource Libraries: Create article-based resource collections
  • Course Materials: Display course documents within lesson articles
  • Support Articles: Attach relevant documentation to help articles

Permission Handling

  • Public Documents: Display to all users
  • Restricted Documents: Show to authorized users only
  • No Access: Hide completely or show "Access Denied" message (based on configuration)

Comparison with Other Plugins

vs Content - EDocman Link:

  • Document Plugin: Full document display with all details
  • Link Plugin: Compact download button only

vs Content - EDocman Category:

  • Document Plugin: Single document embedding
  • Category Plugin: All documents from entire category

Choose based on how much information you want to display.

Troubleshooting

Shortcode Displays as Text:

  • Verify plugin is enabled
  • Check shortcode syntax (correct brackets and spelling)
  • Ensure document ID is valid

Document Not Appearing:

  • Verify document exists and is published
  • Check user has permission to view document
  • Review document access level settings

Layout Issues:

  • Check component theme settings
  • Verify article template doesn't conflict with document styling
  • Review custom CSS

Tips

  1. Use meaningful document titles - they display prominently
  2. Add short descriptions to documents for better article integration
  3. Keep thumbnail dimensions consistent across embedded documents
  4. Test with different user access levels to verify permissions
  5. Use multiple shortcodes to create curated document collections in articles
  6. Combine with article category to organize related document-rich content

Updated: January 2026