Allow to import template files relative to root

[johanjanssens]

Note: This PR required joomlatools/joomlatools-framework#151 for testing

Moved the /pages folder one level lower and make it a required folder. The minimum structure now is

• joomlatools-pages
  • pages

The root folder can be configured in the page:// locator.

The changes allow to import templates relative to the root folder, to test use:

• /file.html
• /folder/file.html

Following imports are resolved against the root folder, eg joomlatools-files.

• file.html
• folder/file.html

Following imports are resolved relative from the folder the template is imported into.

• ../file.html
• ../folder/file.html

Following imports are resolved relative from the folder the template is imported into. The last allow to jump out of the root folder, haven't tested this yet, probably need to harden for this.

Examples:

<?= import('/templates/file'); ?>

Will load a partial from root, eg /joomlatools-pages/

<?= import('../file'); ?>

Will load a partial relative from the file the import is used into

Notes:

As part of the changes made in: #9 a page template no longer requires a '.html' suffix.

[johanjanssens]

@raeldc Added additional check to prevent directory traversal attempts outside of the pages root.

[raeldc]

Tested. Everything works as the ticket described. Only broke it by recursively importing files - which can be fixed on the framework level.

[johanjanssens]

@raeldc I have added basic support for detecting recursion. Can you check if that solves it for your use-case?