Installation

Joomlatools Pages can be installed in any one of three ways: using the Joomla Installer; with Composer; or, using Joomlatools Console

Table of contents

• Requirements
• Installing with the Joomla Installer (recommended)
• Installing with Composer (for testing)
• Installing with Joomlatools Console (for development)

Requirements

• PHP7.4 or newer
• Joomla 3.x
• Joomlatools Framework v3.5

Note that Joomla 4 is not yet supported

Installing with the Joomla Installer

This is the default and recommended installation procedure and is intended for when you want to start exploring pages for your own Joomla sites.

1. Download the latest release package: com_pages_v0.22.4.zip

2. Upload the package using the Joomla installer.

Or

1. Use the Install from URL feature, copy/paste the following url: https://files.joomlatools.com/pages

Installing with Composer

In Joomla

1. At the root of your Joomla site, edit composer.json and add the following:

"minimum-stability": "dev"

3. In your terminal, go to your Joomla site folder and run the following command (*):

$ composer require joomlatools/pages --ignore-platform-reqs

4. Login to your site administrator with the login details admin/admin.
5. Navigate to Extensions > Manage and you should find joomlatools in the list.

(*) You need to use the --ignore-platform-reqs flag otherwise the installation will fail due to a mismatch in the platform constraint. Joomla requires PHP 5.3.10 as a minimum, whereas, Joomlatools Pages requires PHP7.4 as a minimum.

Standalone

Go to the root directory of your installation in command line and execute this command:

composer require joomlatools/pages

When installing standalone you need to use the --no-plugins flag if not the installation will fail due as it will try to execute the composer plugins for Joomla

For further information on how to complete the setup please check following PR: Allow Pages to run standalone #691

Installation with Joomlatools Console

This installation procedure is intended for when you want to contribute to Pages development. It sets up Pages directly from Git to allow you to easily submit PRs.

1. Install Joomlatools Vagrant Box

2. In your Joomlatools Box, create your site.

$ joomla site:create mysite

3. Clone or download Joomlatools Framework and Joomlatools Pages into your Projects folder.

4. Symlink joomlatools-framework and joomlatools-pages into your site.

$ joomla extension:symlink mysite joomlatools-framework
$ joomla extension:symlink mysite joomlatools-pages

5. Register the framework and the pages component:

$ joomla extension:register mysite joomlatools plugin
$ joomla extension:register mysite pages component

6. Login to your site administrator with the login details admin/admin.
7. Navigate to Extensions > Manage and you should find joomlatools and pages in the list.

Congratulations! You are all set to create your first page