Developers
Permissions and settings
PageTree registers two permissions and one settings page. Custom blocks are reserved for superusers.
Permissions
Permissions are granted in Settings → Administrators, on a role or an administrator, in the PageTree section.
| Permission | Code | Allows |
|---|---|---|
| Manage block pages | lucaspalomba.pagetree.pages |
Open the editor, create, edit and delete pages. Edit the pages directly on the website and see the inactive, unpublished or scheduled pages there. |
| Manage block pages settings | lucaspalomba.pagetree.settings |
Edit the plugin settings. |
The internal pagetree/* back-office routes (the preview and the editing on the website) require a back-office session and the lucaspalomba.pagetree.pages permission.
Custom blocks
Custom blocks are managed by superusers only. The lucaspalomba.pagetree.manage_custom_blocks permission is checked but not registered: no role can receive it. The reason is explained in Custom blocks.
Typical profiles
| Profile | Permissions |
|---|---|
| Content editor | Manage block pages |
| Site manager | Manage block pages, Manage block pages settings |
| Integrator (custom blocks) | Superuser account |
Settings
The settings are in Settings → Block Pages Settings, PageTree category. The Manage block pages settings permission is required.
Menu
| Setting | Purpose |
|---|---|
| Navigation Label | Label of the back-office menu entry. Default: "Block Pages". |
Preview without a layout
These settings are used by the preview when no layout is selected.
| Setting | Purpose |
|---|---|
| Select Default Styles | Stylesheets from the assets/css folder of the active theme to load. |
| Add custom styles | Other stylesheets (CDN, other paths), with the Prepend option to load them first. |
| Select Default Scripts | Scripts from the assets/js folder of the active theme to load. |
| Add custom scripts | Other scripts (CDN, other paths), with the Prepend option. |
SEO
These default values are used by the pages and by the pageTreeSeo component.
| Setting | Purpose |
|---|---|
| Site name | Replaces {site} in the title template and is used for og:site_name. Default: name of the active site. |
| Title template | Format of the <title> tag, for example {title} | {site}. Empty: the title alone is used. |
| Default robots | Applied to pages that do not define their own robots value. |
| Twitter/X account | Account of the site, for example @mysite (twitter:site). |
| Default sharing image | Used when a page has no Open Graph image. 1200 × 630 px recommended. |