Version: 1.51
Author: Eren - Aymak
License: GPL
XOOPS: 2.5.11+
PHP: 7.4 - 8.2
Xcreate is a professional content management module developed for XOOPS. It lets you build flexible content structures with category-based dynamic custom fields.
✅ Dynamic Content Structure - Different field sets for each category
✅ 14 Different Field Types - Text, textarea, select, checkbox, radio, date, file, image, and more
✅ Category Hierarchy - Unlimited subcategory support
✅ Custom Templates - Custom view for each category
✅ Repeatable Fields - Enter multiple values for the same field
✅ File Management - Image and file upload system
✅ Multi-language - Turkish and English language support
✅ User Permissions - Group-based authorization
# Extract the ZIP file into the XOOPS root directory
unzip xcreate.zip
mv xcreate modules/
# Set permissions
chmod -R 755 modules/xcreate- Log in to the XOOPS admin panel
- Go to System > Modules
- Find the Xcreate module
- Click the Install button
- Xcreate > Categories - Create your first category
- Xcreate > Custom Fields - Define fields for the category
- Xcreate > Items - Start adding content
| Field Type | Description | Use Case |
|---|---|---|
| text | Single-line text | Title, name, phone |
| textarea | Multi-line text | Description, address |
| editor | HTML editor | Rich content |
| select | Dropdown list | Making a selection |
| checkbox | Multiple choice | Multiple options |
| radio | Single choice | One option |
| date | Date picker | Birth date, date |
| datetime | Date + Time | Event time |
| number | Numeric input | Price, quantity |
| Email address | Contact | |
| url | Web address | Link |
| color | Color picker | Theme color |
| image | Image upload | Visual content |
| file | File upload | Document, PDF |
Category: Apartments for Sale
Custom Fields:
- Price (
number) - Square Meters (
number) - Room Count (
select: 1+1, 2+1, 3+1, 4+1) - Floor (
number) - Heating (
select: Combi Boiler, Central, Air Conditioning) - Orientation (
radio: North, South, East, West) - Features (
checkbox: Elevator, Parking, Balcony, Security) - Photos (
image- repeatable)
Category: Software
Custom Fields:
- Position (
text) - Experience (
select: 0-2 years, 2-5 years, 5+ years) - Salary Range (
text) - Company (
text) - Work Type (
radio: Office, Remote, Hybrid) - Skills (
checkbox- repeatable) - Application Date (
date) - Logo (
image)
Category: Electronics
Custom Fields:
- Brand (
select) - Model (
text) - Price (
number) - Stock (
number) - Color Options (
checkbox) - Warranty Period (
number) - Product Images (
image- repeatable) - Technical Document (
file)
Xcreate uses the following template files:
xcreate_index.tpl- Main page listxcreate_item.tpl- Content detail pagexcreate_submit.tpl- Content submission form
You can define a custom template for each category:
- While editing a category, enter the template name in the "Custom Template" field (example:
real-estate) - The template is automatically created at
templates/real-estate.tpl - Customize the template
Example Template Code:
<div class="xcreate-item">
<h1>{$item.title}</h1>
<div class="item-description">
{$item.description}
</div>
{if $custom_fields}
<div class="custom-fields">
{foreach item=field from=$custom_fields}
<div class="field-group">
<label>{$field.label}:</label>
<div class="field-values">
{foreach item=value from=$field.values}
<span class="field-value">{$value}</span>
{/foreach}
</div>
</div>
{/foreach}
</div>
{/if}
</div>Repeatable fields allow users to enter multiple values for the same field.
- Multiple phone numbers
- Multiple image uploads
- More than one email address
- Multiple social media links
- Check the "Repeatable" box when creating the custom field
- The user can add another field in the form with the "+ Add" button
- In the template, all values are provided as an array
Usage in a Template:
{foreach item=phone from=$field.values}
<a href="tel:{$phone}">{$phone}</a>
{/foreach}- View: Which categories they can see
- Submit Content: Which categories they can add content to
- Edit: They can edit their own content
- Delete: They can delete their own content
- Full access to all categories
- Manage all content
- Define custom fields
- Configure permission settings
✅ SQL Injection protection
✅ XSS (Cross-Site Scripting) protection
✅ CSRF token validation
✅ File upload security
✅ Extension validation
✅ Size limit
xcreate_categories
- Category information
- Hierarchical structure (
parent_id) - Custom template information
xcreate_fields
- Custom field definitions
- Field type and properties
- Sort order information
xcreate_field_options
select,checkbox,radiooptions
xcreate_items
- Content records
- Category relationship
- Status information
xcreate_field_values
- Field values
- Multi-value support
- File information
Configurable settings available from the admin panel:
| Setting | Description | Default |
|---|---|---|
| Items Per Page | Number of items to show on list pages | 10 |
| User Submission | Allow users to submit content | Yes |
| Maximum File Size | Maximum uploadable file size (KB) | 2048 |
| Allowed Extensions | Uploadable file types | jpg,jpeg,png,gif,pdf,doc,docx |
- Create a backup:
cp -r modules/customfields modules/customfields.backup
mysqldump -u root -p xoops_db > backup.sql- Update the files:
unzip xcreate.zip
rm -rf modules/customfields
mv xcreate modules/- Update the database:
-- Rename the tables
RENAME TABLE customfields_categories TO xcreate_categories;
RENAME TABLE customfields_fields TO xcreate_fields;
RENAME TABLE customfields_field_options TO xcreate_field_options;
RENAME TABLE customfields_items TO xcreate_items;
RENAME TABLE customfields_field_values TO xcreate_field_values;- Update the module in XOOPS:
- Admin > Modules > Xcreate > Update
Solution: Fixed in v1.51. If the problem still exists:
// Enable debug mode
define('XOOPS_DEBUG_MODE', 1);
// Check database errors
echo $xoopsDB->error();Solution: Fixed in v1.51. Clear the cache:
rm -rf cache/*
rm -rf templates_c/*Checklist:
- Is
PHP upload_max_filesizelarge enough? - Does the
uploads/xcreatefolder exist? - Are the permissions correct? (
755) - Is the file extension in the allowed list?
To display Xcreate data in templates:
{* Show the latest 5 items from the category *}
{xcreate cat_id=1 limit=5 assign=items}
{foreach item=item from=$items}
<h3>{$item.title}</h3>
<p>{$item.description}</p>
{/foreach}// Load the handler
include_once XOOPS_ROOT_PATH . '/modules/xcreate/class/item.php';
$itemHandler = new XcreateItemHandler($xoopsDB);
// Get recent items
$items = $itemHandler->getRecentItems(10);
foreach ($items as $item) {
echo $item->getVar('item_title');
}- README.md - This file
- CHANGELOG.md - Version history
- XOOPS forums
If you experience a problem:
- Enable XOOPS debug mode
- Check the PHP error logs
- Review database errors
- Report the issue with a detailed description
- Category management (hierarchical)
- 14 different field types
- Repeatable fields
- Custom template system
- File and image uploads
- Multi-language support
- User permissions
- Admin panel
- Smarty plugin
- Delete operations (v1.51)
- Bug fixes (v1.51)
- REST API
- Import/Export
- Bulk actions
- Field validation improvements
- Icon sets
- More field types
This module is distributed under the GPL (GNU General Public License).
- To the XOOPS community
- To the users who tested the module
- To everyone who provided feedback
Professional content management with Xcreate! 🚀
Version: 1.51
Date: November 25, 2024
Developer: Eren - Aymak
Website: https://aymak.com.tr