Home - slackero/phpwcms GitHub Wiki

Welcome to the phpwcms wiki!

phpwcms is a fast, flexible and developer-friendly open source CMS and CMS framework running on PHP and MySQL/MariaDB. These pages collect HowTos that go beyond the manual — the current reference documentation ships inside the repository under docs/.

Quick links

• Website — phpwcms.org
• Support forum — forum.phpwcms.org
• Releases — github.com/slackero/phpwcms/releases
• Changelog — CHANGELOG.md
• Security policy — SECURITY.md
• PHP requirements — docs/requirements
• Installing and updating — docs/installation

Documentation (phpwcms 2.x)

The complete reference manual ships with the source in docs/. It covers the current branch only. Start at docs/index.md, or browse the section indexes below — every single page is listed in docs/llms.txt.

• General — core concepts, URL handling
• Requirements — system requirements: server, PHP, database and extensions
• Installation and updates — fresh installation, setup wizard, Docker, updating, configuration file
• Administration — admin panel, users and usergroups, file storage, SEO settings, cache and performance, image processing, whitelabel branding
• Backend — overview, structure tree, articles, files and file center, messaging, profile
• Frontend — page rendering, frontend scripts, deprecated tags, RSS feeds, and the replacement tag reference (NAV_LIST_UL, SHOW_CONTENT, meta, date/time, login, RSS, functions)
• Templates — template system, layout tags, template editor, default templates, assets and libs
• Content parts — all 37 content part types
• Modules — all shipped modules: shop, calendar, newsletter, ads, feed import, addresses, SEO log, statistics, glossary

Older documentation (phpwcms 1.x)

These community sites predate the documentation that ships with phpwcms 2.x. They still help with legacy 1.x installations, but they do not describe current releases:

• docu.phpwcms.org — German language documentation site, covering phpwcms up to 1.7.x, last updated in 2015
• wiki.phpwcms.org — snapshot of the former community HowTo wiki
• yaml.phpwcms.org — “yamlit”, step-by-step tutorials for building phpwcms templates on the YAML CSS framework (YAML 3.1 era)

The support forum at forum.phpwcms.org is still active and is the place to ask about any phpwcms version.

Versions and PHP

phpwcms	GitHub branch	PHP
2.0.x (beta, 2.0.0-beta.2)	v2-dev	8.4 or newer
1.12.x (stable, 1.12.5)	master, v1.10-dev	8.2 or newer
1.9.x (legacy, 1.9.51)	v1.9-dev, phpwcms-legacy	7.4 or newer

Details, including what to watch when moving an old installation to a newer PHP, are on Updating PHP.

Recent releases

• 2026-11-01 — 2.0.0-beta.2 (prerelease): raises the runtime baseline to PHP 8.4, fixes form file size/max persistence, article content part type on form submit, file usage detection in custom fields, and the revision engine.
• 2026-11-01 — 1.12.5: the revision engine runs every pending revision instead of only the newest one (an upgrade from 1.9.50 could skip r554 and hide all articles), drops the obsolete sysvalue_tstamp column and the phpwcms_bad_behavior table, plus dependency updates.
• 2026-11-01 — 1.9.51: the same revision engine fix for the PHP 7.4 legacy line, plus dependency updates.
• 2026-10-03 — 1.12.4 / 1.9.50 / 2.0.0-beta.1: security releases fixing CVE-2026-110025 (unauthenticated .phtml upload leading to remote code execution) together with the 2026-09 audit findings. Run 1.9.51+, 1.12.5+ or 2.0.0-beta.2+ — every older version is affected.

Full history: CHANGELOG.md and the release notes.

Installing phpwcms

1. Place the phpwcms files in your web server's document root.
2. Installing from Git requires the Composer dependencies: composer install (PHP 8.4 for 2.x, PHP 8.2 for 1.12.x). Release archives already ship include/vendor/.
3. Open http://your-domain.com/setup/ and follow the setup wizard to configure the database and your administrator account.
4. Remove or protect the /setup folder afterwards, and use the shipped server config as a starting point: _.htaccess (Apache), nginx.conf (Nginx) or web.config (IIS).

Full walkthrough: docs/installation.

Updating an existing installation

Back up the database and the files (include/config/conf.inc.php, template/, filearchive/, content/images/, content/tmp/) to a location off the web server before you start.

• phpwcms 2.0.0 and newer: Admin → System Update (phpwcms.php?do=admin&p=18).
• Older installations and 1.x migrations: run setup/upgrade.php from the command line or in the browser.

Both paths need PHP 8.4 or newer for 2.x, or PHP 8.2 for 1.12.x. See Updating PHP and docs/installation/updating.md.

Wiki pages

These pages apply to current phpwcms releases:

• Updating PHP — supported PHP versions per branch, and what to watch when moving an installation to a newer PHP
• Reserved aliases — alias names phpwcms blocks, how a collision is renamed per target type, and how to extend the list
• Content Parts — content part IDs and backend labels, how the part stack renders, with a link to the reference page of every type
• CKEditor Configuration — adjusting the legacy CKEditor 4 backend editor; phpwcms 2.x ships TinyMCE 8 as the default editor

These pages only describe phpwcms 1.x and are kept for legacy installations:

• Cannot redeclare boolval() with PHP5.5 — fatal boolval() collision when moving an old installation to PHP 5.5
• WYSIWYG images empty — missing editor images after a PHP 5.5/5.6 upgrade
• Update PHP to version 5.5 or 5.6 — former PHP upgrade page, now a pointer to Updating PHP