Publisher Module
The premier news and blog publishing module for XOOPS CMS.
Overview
Section titled “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
Section titled “🌟 Key Features”Content Management
Section titled “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
Section titled “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
Section titled “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
Section titled “User Interaction”- Ratings - Article rating system
- Comments - Reader discussions
- Social Sharing - Share to social networks
Permissions
Section titled “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
Section titled “🗂️ Section Contents”User Guide
Section titled “User Guide”- Installation Guide
- Basic Configuration
- Creating Articles
- Managing Categories
- Setting Up Permissions
Developer Guide
Section titled “Developer Guide”- Extending Publisher
- Creating Custom Templates
- API Reference
- Hooks and Events
🚀 Quick Start
Section titled “🚀 Quick Start”1. Installation
Section titled “1. Installation”# Download from GitHubgit clone https://github.com/XoopsModules25x/publisher.git
# Copy to modules directorycp -r publisher /path/to/xoops/htdocs/modules/Then install via XOOPS Admin → Modules → Install.
2. Create Your First Category
Section titled “2. Create Your First Category”- Go to Admin → Publisher → Categories
- Click Add Category
- Fill in:
- Name: News
- Description: Latest news and updates
- Image: Upload category image
- Save
3. Create Your First Article
Section titled “3. Create Your First Article”- Go to Admin → Publisher → Articles
- Click Add Article
- Fill in:
- Title: Welcome to Our Site
- Category: News
- Content: Your article content
- Set Status: Published
- Save
⚙️ Configuration Options
Section titled “⚙️ Configuration Options”General Settings
Section titled “General Settings”| Setting | Description | Default |
|---|---|---|
| Editor | WYSIWYG editor to use | XOOPS Default |
| Items per page | Articles shown per page | 10 |
| Show breadcrumb | Display navigation trail | Yes |
| Allow ratings | Enable article ratings | Yes |
| Allow comments | Enable article comments | Yes |
SEO Settings
Section titled “SEO Settings”| Setting | Description | Default |
|---|---|---|
| SEO URLs | Enable friendly URLs | No |
| URL rewriting | Apache mod_rewrite | None |
| Meta keywords | Auto-generate keywords | Yes |
Permissions Matrix
Section titled “Permissions Matrix”| Permission | Anonymous | Registered | Editor | Admin |
|---|---|---|---|---|
| View articles | ✓ | ✓ | ✓ | ✓ |
| Submit articles | ✗ | ✓ | ✓ | ✓ |
| Edit own articles | ✗ | ✓ | ✓ | ✓ |
| Edit all articles | ✗ | ✗ | ✓ | ✓ |
| Approve articles | ✗ | ✗ | ✓ | ✓ |
| Manage categories | ✗ | ✗ | ✗ | ✓ |
📦 Module Structure
Section titled “📦 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
Section titled “🔄 Migration”From SmartSection
Section titled “From SmartSection”Publisher includes a built-in migration tool:
- Go to Admin → Publisher → Import
- Select SmartSection as source
- Choose import options:
- Categories
- Articles
- Comments
- Click Import
From News Module
Section titled “From News Module”- Go to Admin → Publisher → Import
- Select News as source
- Map categories
- Click Import
🔗 Related Documentation
Section titled “🔗 Related Documentation”- Module Development Guide
- Smarty Templating
- XMF Framework
📚 Resources
Section titled “📚 Resources”#xoops #publisher #module #blog #news #cms #content-management