phpBB Extension - Pages

An extension which allows you to add static pages to your phpBB forum

phpbb, extension, static, pages
https://www.phpbb.com

Authors of extension

  • Marc Alexander Marc Alexander
    Role: Extensions Team Consultant
    E-Mail: admin (at) m-a-styles.de
  • Michael Cullum Michael Cullum
    Role: Extensions Team Consultant
    E-Mail: michael (at) phpbb.com
  • Matt Friedman Matt Friedman
    Role: Extensions Development Team Lead
  • Nathan Guse Nathan Guse
    Role: Former Extensions Development Team Lead
    E-Mail: nathaniel.guse (at) gmail.com
  • Lukasz Kaczynski Lukasz Kaczynski
    Role: Extensions Development Team
  • John Peskens John Peskens
    Role: Extensions Development Team

Install Extension

Install in ACP

Use our Install tool to install this Extension. Navigate to "CUSTOMISE - Install extensions" in the ACP of your forum and search for Pages and click the install button.

Manual install

Download the archive of the extension from here and unpack it. Copy then the entire contents of the archive to your phpBB forum to /ext/phpbb/pages, maybe you need to remove "_master" from the extracted folder. Now go into the admin area of the forum and chose the tab Customize, in the area Manage extensions is you now the extension Pages displayed under the disable extensions. Click behind the extension on the link Enable to activate the extension. After you have confirmed the action the extension is available in your forum.

Read me

phpBB Pages Extension

This is the repository for the development of the phpBB Pages Extension.

Build Status

Install

  1. Download the latest validated release.
  2. Unzip the downloaded release and copy it to the ext directory of your phpBB board.
  3. Navigate in the ACP to Customise -> Manage extensions.
  4. Look for Pages under the Disabled Extensions list, and click its Enable link.
  5. Set up and configure Pages by navigating in the ACP to Extensions -> Pages.

Uninstall

  1. Navigate in the ACP to Customise -> Extension Management -> Extensions.
  2. Look for Pages under the Enabled Extensions list, and click its Disable link.
  3. To permanently uninstall, click Delete Data and then delete the /ext/phpbb/pages directory.

Support

  • Important: Only official release versions validated by the phpBB Extensions Team should be installed on a live forum. Pre-release (beta, RC) versions downloaded from this repository are only to be used for testing on offline/development forums and are not officially supported.
  • Report bugs and other issues to our Issue Tracker.
  • Support requests should be posted and discussed in the Pages topic at phpBB.com.

Translations

  • Translations should be posted to the Pages topic at phpBB.com. We accept pull requests for translation corrections, but we do not accept pull requests for new translations.

Customising Pages

Custom Page Link Icons

Whether you want a more personalised look or need icons that will work with each of your installed styles' color palettes, it's easy to add your own unique custom page link icons.

To get started, your custom icons must follow a specific naming structure of the form: pages_route.gif wherein route must be the name of the route defined for the page the icon is associated with. For example, a page with the route foobar would use the icon pages_foobar.gif. The image must also be a GIF.

The custom icons should be kept in phpBB's style/*/theme/images directories, for example: phpbb/styles/prosilver/theme/images/pages_foobar.gif. You should add your custom icon to every style installed on your board (you can design different icons for each style if necessary). If Pages can't find an icon it will fallback to its default icon.

Alternatively, style authors and other experienced users that don't want to use individual image files for icons, can use the CSS classes which are added to the page links automatically. These classes allow you to change the styling of the link (including icons) to replace the default icon, using CSS. These classes follow the naming structure of the form: icon-page-route wherein route is the name of the route as defined in the extension's ACP module.

Custom Page Templates

Custom page templates offer tremendous flexibility for the appearance and content of your Pages. They can be used to bring additional HTML content, javascript and CSS to your Pages or to better integrate your Pages with other styles installed on your board.

Page templates must follow a naming structure of the form: pages_*.html where * can be any name you want. Pages ships with two templates that can be used as a basis for your custom templates, and they have helpful comments in them about including external javascript and CSS files. All available page templates will appear in the ACP when you create/edit pages where they can be assigned to a page.

Because these are actual templates, just like any other style template files, you can use phpBB's template syntax (or TWIG) in them as well, to add events, include additional template files, and render or display content based on available template variables. They can NOT, however, be used to execute PHP code.

Page templates follow phpBB's style inheritance. A page template designed for Prosilver and Prosilver-based styles need only be added to Prosilver's template directory. However, you can add other versions of that page template to other styles too, if needed (such as to match the look of the specific style). Page templates found in child styles of Prosilver or subsilver2 will override page templates inherited from the parent style. The only caveat is that you can not override the two page templates that ship with this extension, meaning you can not use pages_default.html or pages_blank.html for names of your custom page templates. Additionally, custom page templates should be kept in phpBB's style/*/template directories; not in the Pages extension's style directories.

We recommend keeping custom icons and templates stored in phpBB's style directories rather than in Pages' style directories, as this prevents accidental deletion of your custom files whenever the Pages extension is updated.

Converting from a MOD

Pages can convert/import data from Static Pages MOD 1.0.3. If Pages finds the Static Pages MOD data in your database, it will automagically convert it when you enable Pages. To complete the transition, we recommend you review the Static Pages MOD's install instructions in order to remove the file-edits to constants.php and delete all of the included files the MOD added to your forum.

Note: Pages will keep a backup of the Static Pages MOD data in a database table named pages_mod_backup. Pages will never delete or alter this backup table. Pages has not been tested with any other similar MODs.

License

GNU General Public License v2

Comments


No comments have been posted yet for this extension. Rate the extension now and write the first comment.


Last updated: 29. July 2018 05:37:47

Use this image

You can use this image on your Website to show visitors the rating of your Extension.

Rating

Image URL

https://phpbb-extensions.ga/phpbb/pages.png

Image HTML

<a href="https://phpbb-extensions.ga/phpbb/pages"><img src="https://phpbb-extensions.ga/phpbb/pages.png" alt="Pages"></a>

Markdown

[![Pages](https://phpbb-extensions.ga/phpbb/pages.png)](https://phpbb-extensions.ga/phpbb/pages)

BB Code

[url=https://phpbb-extensions.ga/phpbb/pages][img]https://phpbb-extensions.ga/phpbb/pages.png[/img][/url]