Skip to content
Johan Janssens edited this page Jun 12, 2021 · 13 revisions

This is a step-by-step walkthrough on installing and building your first page with Joomlatools Pages.

Create the root folder

In the root folder of your Joomla installation, create the following folder structure:

  • joomlatools-pages
    • pages

Create your first page

To create a new page, simply go to your /joomlatools-pages/pages directory and add a new file. In this example, we'll use the file hello.html but you can name it anything you like. Open the file in a text editor and paste the following snippet:

<h3>Hello World!</h3>
<p>Welcome to my new page.</p>

Now save this, and in your browser go to http://example.com/index.php/hello

Tip: If you have url rewriting enabled (recommended) in Joomla you can drop the /index.php and use http://example.com/hello

Multilingual setup

The location of your page on the filesystem follows the absolute path of your url. So if your are running a multi-ligual site your page will need to go into in the subfolder that corresponds with your language, otherwise Pages will not be able to find it.

For example: http://example.com/en/hello you need to create your page in /joomlatools-pages/pages/en/hello.html

Creating a menu item (optional)

The following steps are options and not required, however if you want Joomla to show a menu item for your page you can do so by creating one.

In the administrator interface, go to your menu manager and create a new menu item. The Menu Item Type should be System Links > URL. Add the title and alias, making sure that the alias matches the file you created. For example:

  • Title: Hello World
  • Alias: hello
  • URL: /hello

The alias can be anything. The URL should be the exact path of the page relative to your /joomlatools-pages directory.