01555: Disable editing in default installation

Summary: Disable editing in default installation
Created: 2026-05-21 07:08
Status: Open
Category: Feature
From: Petko
Assigned:
Priority: 52
Version:
OS:

Description:

PmWiki upgrades are somewhat complex as the core distribution is interspliced with local configuration, cookbook recipes, and skins.

In order to simplify upgrades, we should make it possible for a release software tree "no-need-to-touch" (PITS:01501). This means the local, cookbook, extensions, wiki.d, pub/css, pub/skins directories should somehow go outside of the default installation, like a field on a wiki farm.

We also want to make it easy for people to install and test PmWiki. It is currently possible to just drop the distribution on a server without any index.php or config.php, visit pmwiki.php and start editing. This will populate wiki.d within the core distribution tree and is not ideal for future upgrades.

The ease of first use OOTB and the ease of future upgrades are incompatible.

The proposal here is to either make a default installation without local/config.php read-only, or to enable Cookbook:SessionPageStore for ephemeral saving of changes, with conspicuous warnings.

Once people add an index.php file, and a local/config.php file, the wiki will become editable.

Existing wikis using the core directory tree should not be affected on an upgrade. Petko