📰 Publisher Module¶

The premier news and blog publishing module for XOOPS CMS.

Overview¶

Publisher is the definitive content management module for XOOPS, evolved from SmartSection to become the most feature-rich blog and news solution. It provides comprehensive tools for creating, organizing, and publishing content with full editorial workflow support.

Requirements: - XOOPS 2.5.10+ - PHP 7.1+ (PHP 8.x recommended)

🌟 Key Features¶

Content Management¶

• Categories & Subcategories - Hierarchical content organization
• Rich Text Editing - Multiple WYSIWYG editors supported
• File Attachments - Attach files to articles
• Image Management - Page and category images
• File Wrapping - Wrap files as articles

Publishing Workflow¶

• Scheduled Publishing - Set future publish dates
• Expiration Dates - Auto-expire content
• Moderation - Editorial approval workflow
• Draft Management - Save work in progress

Display & Templates¶

• Four Base Templates - Multiple display layouts
• Custom Templates - Create your own designs
• SEO Optimization - Search engine friendly URLs
• Responsive Design - Mobile-ready output

User Interaction¶

• Ratings - Article rating system
• Comments - Reader discussions
• Social Sharing - Share to social networks

Permissions¶

• Submission Control - Who can submit articles
• Field-Level Permissions - Control form fields by group
• Category Permissions - Access control per category
• Moderation Rights - Global moderation settings

🗂️ Section Contents¶

User Guide¶

• Installation Guide
• Basic Configuration
• Creating Articles
• Managing Categories
• Setting Up Permissions

Developer Guide¶

• Extending Publisher
• Creating Custom Templates
• API Reference
• Hooks and Events

🚀 Quick Start¶

1. Installation¶

# Download from GitHub
git clone https://github.com/XoopsModules25x/publisher.git

# Copy to modules directory
cp -r publisher /path/to/xoops/htdocs/modules/

Then install via XOOPS Admin → Modules → Install.

2. Create Your First Category¶

1. Go to Admin → Publisher → Categories
2. Click Add Category
3. Fill in:
4. Name: News
5. Description: Latest news and updates
6. Image: Upload category image
7. Save

3. Create Your First Article¶

1. Go to Admin → Publisher → Articles
2. Click Add Article
3. Fill in:
4. Title: Welcome to Our Site
5. Category: News
6. Content: Your article content
7. Set Status: Published
8. Save

⚙️ Configuration Options¶

General Settings¶

SEO Settings¶

Permissions Matrix¶

📦 Module Structure¶

modules/publisher/
├── admin/                  # Admin interface
│   ├── index.php
│   ├── category.php
│   ├── item.php
│   └── menu.php
├── class/                  # PHP classes
│   ├── Category.php
│   ├── CategoryHandler.php
│   ├── Item.php
│   ├── ItemHandler.php
│   └── Helper.php
├── include/                # Include files
│   ├── common.php
│   └── functions.php
├── templates/              # Smarty templates
│   ├── publisher_index.tpl
│   ├── publisher_item.tpl
│   └── publisher_category.tpl
├── language/               # Translations
│   └── english/
├── sql/                    # Database schema
│   └── mysql.sql
├── xoops_version.php       # Module info
└── index.php               # Module entry

🔄 Migration¶

From SmartSection¶

Publisher includes a built-in migration tool:

1. Go to Admin → Publisher → Import
2. Select SmartSection as source
3. Choose import options:
4. Categories
5. Articles
6. Comments
7. Click Import

From News Module¶

1. Go to Admin → Publisher → Import
2. Select News as source
3. Map categories
4. Click Import

🔗 Related Documentation¶

• Module Development Guide
• Smarty Templating
• XMF Framework

📚 Resources¶

• GitHub Repository
• Issue Tracker
• Original Tutorial

xoops #publisher #module #blog #news #cms #content-management¶