Complete Guide
What the Plugin Does
- Creates a separate table
cot_xtradbrowpage to store extra fields for pages. Each record is linked to a page via itempagid = page_id with cascading delete. - Registers the
cot_xtradbrowpage location in the admin panel under "Extensions → Extrafields". - When editing a page, automatically outputs all active extra fields of this location (form fields with the
rxtra_ prefix, tags {PAGEEDIT_FORM_XTRA_FIELDNAME}). Saves them on page update. - On the page view, provides tags
{XTRA_FIELDNAME}, {XTRA_FIELDNAME_TITLE}, {XTRA_FIELDNAME_VALUE}, and a block <!-- BEGIN: XTRA_EXTRAFLD --> to loop through all fields. - In page lists (via
cot_generate_pagetags()), tags with the prefix {LIST_ROW_XTRA_...} are available. - In the
<head> section (header.tags hook), you can use {XTRA_HEADER_FIELDNAME}. - When a page is deleted, the corresponding record in
cot_xtradbrowpage is removed either by cascade or explicitly (page.edit.delete.done hook). - Provides three API functions for manual operations.
Requirements
- Cotonti 0.9.26+
- PHP 8.4+
- The "page" module must be installed
permanent link to the current plugin source code on GitHub
Installation
- Copy the plugin folder to
/plugins/xtradbrowpage. - In the admin panel, go to "Extensions → Plugins" and click "Install".
Installation SQL (executed automatically):
CREATE TABLE IF NOT EXISTS `cot_xtradbrowpage` (
`itempagid` int UNSIGNED NOT NULL,
PRIMARY KEY (`itempagid`),
CONSTRAINT `fk_xtradbrowpage_pages` FOREIGN KEY (`itempagid`) REFERENCES `cot_pages` (`page_id`) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
Adding Extra Fields
- In the admin panel: "Extensions → Extrafields".
- Select the
cot_xtradbrowpage location (appears after plugin installation). - Create fields of the required types. Allowed types:
input, textarea, select, datetime, double, and any others supported by the Cotonti core.
Example Field Set (from database dump)
| Field Name | Type | HTML Template | Variants / Parameters | Description |
| event_name | input | <input class="form-control" type="text" name="{$name}" value="{$value}" maxlength="255"> | | Event name |
| event_description | textarea | <textarea class="form-control" name="{$name}" rows="{$rows}" cols="{$cols}" maxlength="255">{$value}</textarea> | | Event description |
| event_start | datetime | <div class="row g-2"> ... </div> (See the partial SQL Dump) | 2024,2030,d.m.Y H:i | Event start |
| event_ticketprice | double | <input class="form-control" type="text" name="{$name}" value="{$value}" maxlength="255"> | | Ticket price |
| event_seson | select | <select class="form-select" name="{$name}">{$options}</select> | unknown,winter,summer,autumn,spring | Season |
Templates and Tags
1. Edit Form (page.edit.tpl)
Block for automatic output of all fields:
<!-- BEGIN: XTRA_EXTRAFLD -->
<div class="form-group">
<label>{PAGEEDIT_FORM_XTRA_EXTRAFLD_TITLE}</label>
{PAGEEDIT_FORM_XTRA_EXTRAFLD}
</div>
<!-- END: XTRA_EXTRAFLD -->
Individual fields (example for event_name):
<div class="mb-3">
<label>{PAGEEDIT_FORM_XTRA_EVENT_NAME_TITLE}</label>
{PAGEEDIT_FORM_XTRA_EVENT_NAME}
</div>
2. View Page (page.tpl)
Block for all fields:
<!-- BEGIN: XTRA_EXTRAFLD -->
<div class="extrafield">
<strong>{XTRA_EXTRAFIELD_TITLE}:</strong>
<span>{XTRA_EXTRAFIELD_VALUE}</span>
</div>
<!-- END: XTRA_EXTRAFLD -->
Individual field:
<!-- IF {XTRA_EVENT_START} -->
<p>{XTRA_EVENT_START_TITLE}: {XTRA_EVENT_START}</p>
<!-- ENDIF -->
Values are formatted according to the field type (datetime will be formatted as d.m.Y H:i).
3. Page Lists (page.list.tpl, news.tpl, etc.)
Use tags {LIST_ROW_XTRA_FIELDNAME}, e.g.:
<!-- IF {LIST_ROW_XTRA_EVENT_NAME} -->
<small>{LIST_ROW_XTRA_EVENT_NAME_TITLE}: {LIST_ROW_XTRA_EVENT_NAME}</small>
<!-- ENDIF -->
These tags are added via the pagetags.main hook inside the cot_generate_pagetags() function.
4. Head Section (header.tpl)
<!-- IF {XTRA_HEADER_EVENT_NAME} -->
<meta name="event" content="{XTRA_HEADER_EVENT_NAME}">
<!-- ENDIF -->
API for Developers
Functions are located in /plugins/xtradbrowpage/inc/xtradbrowpage.functions.php.
Get all registered fields
$fields = xtradbrowpage_getExtrafields(); // array from Cot::$extrafields['cot_xtradbrowpage']
Load record for a page
$data = xtradbrowpage_load($page_id); // returns an associative array with field_name keys
Save (INSERT or UPDATE)
$values = [
'event_name' => 'New event',
'event_start' => 1715011200, // UNIX timestamp
'event_ticketprice' => 100.50
];
xtradbrowpage_save($page_id, $values);
Plugin Hooks and Their Purpose
| Hook | File | Action |
| admin.extrafields.first | xtradbrowpage.admin.extrafields.first.php | Adds the location to the extra fields whitelist |
| header.tags | xtradbrowpage.header.tags.php | Assigns XTRA_HEADER_* tags for the current page |
| page.edit.tags | xtradbrowpage.page.edit.tags.php | Outputs fields in the edit form and parses the XTRA_EXTRAFLD block |
| page.edit.update.done | xtradbrowpage.page.edit.update.done.php | Saves the submitted values to cot_xtradbrowpage |
| page.edit.delete.done | xtradbrowpage.page.edit.delete.done.php | Explicitly deletes the record for the page |
| page.tags | xtradbrowpage.page.tags.php | Assigns tags for the view page, parses the XTRA_EXTRAFLD block |
| pagetags.main | xtradbrowpage.pagetags.php | Adds LIST_ROW_XTRA_* tags to $temp_array |
Practical Example: Creating Events
1. Adding Fields
Create fields through the admin panel: event_name, event_description, event_start, event_ticketprice, event_seson with the parameters from the table above.
2. Edit Template
<!-- In page.edit.tpl -->
<div class="card mt-3">
<div class="card-header">Event Parameters</div>
<div class="card-body">
<!-- BEGIN: XTRA_EXTRAFLD -->
<div class="mb-3">
<label class="form-label">{PAGEEDIT_FORM_XTRA_EXTRAFLD_TITLE}</label>
{PAGEEDIT_FORM_XTRA_EXTRAFLD}
</div>
<!-- END: XTRA_EXTRAFLD -->
</div>
</div>
3. View Template
<!-- In page.tpl -->
<!-- IF {XTRA_EVENT_NAME} -->
<div class="event-details">
<h2>{XTRA_EVENT_NAME}</h2>
<!-- BEGIN: XTRA_EXTRAFLD -->
<p><strong>{XTRA_EXTRAFIELD_TITLE}:</strong> {XTRA_EXTRAFIELD_VALUE}</p>
<!-- END: XTRA_EXTRAFLD -->
</div>
<!-- ENDIF -->
4. List Output
<!-- In page.list.tpl inside LIST_ROWS block -->
<div class="list-item">
<a href="{LIST_ROW_URL}">{LIST_ROW_TITLE}</a>
<!-- IF {LIST_ROW_XTRA_EVENT_START} -->
<span class="date">{LIST_ROW_XTRA_EVENT_START}</span>
<!-- ENDIF -->
</div>
Field Type Specifics
- datetime: stored as int (UNIX timestamp). In the edit form, dropdowns are provided. On output, formatted according to the
field_params (e.g., d.m.Y H:i). - select: comma-separated values in
field_variants; the selected value is saved as a string. - double: saved as a floating-point number.
- All fields are escaped on output via
cot_build_extrafields_data() and htmlspecialchars().
Notes
- The plugin does not add columns to the
cot_pages table. - If a page is created without immediately saving extra fields, the record in
cot_xtradbrowpage will appear on the first update of the page via the edit form. - For bulk data insertion, use the
xtradbrowpage_save() API function. - Cache clearing is not required, but if you encounter display issues, clear the cache in the admin panel.
Русский 
