09-09-2010 00:32:24

Using Folders

Folders are a feature of modX allowing you to create a "category" with which to store documents under. In this example we have a document called 'Google Friendly URLs' and we'd like to start a 'category' of tutorials covering the various aspects of modX and SEO (search engine optimization) issues that we're calling "SEO Settings".

1.  From the manager, top navigation links (blue), click "Content"

2. In the sub navigation links (in orange) click "New Folder".

3. In the document setting that appear on the right hand side in your browser window, give the document (folder) a name - here we've typed in "SEO Settings". You'll notice that under "Uses template" we've set that to "blank", and that a menu title has been used called "SEO Settings" and that we have selected "Show in menu". We want the folder to appear as a 'Category' for 'documents' contained in it - the folder itself is not intended to hold any content since the topics covered by it are what the documents hold.

4. Click the "Page Settings" link.

5. Locate the check box besides "Published?" and click it.

6. Click "Save".

7. In the document tree on the left, you'll see a new folder ("SEO Settings) has been created.

8. Back at the site - you'll see that a new top level item called "SEO Settings" has been created, it has a name - but it doesn't do anything when you click it, and that's exactly what we intended.

9. Back at the manager, we now want to put (or file) the document "Google Friendly URLs" inside the "SEO Settings" folder.

10. Selecting the document to be moved in the document tree, click on "Edit".

11. In the document settings on the left hand side of your browser window, locate "Document Parent" and 'click' it.

12. In the document tree on the left hand side, choose the 'folder' that you want to use as the documents 'Parent" and click it.

13. You'll see that the "Document parent" has now changed to "15 (SEO Settings)".

14. Locate the "Save" link - and click it.

15. You'll see in the document tree, that our document "Google Friendly URLs" is now filed under the folder "SEO Settings". The term sometimes used to sum this up, is that the document "Google Friendly URLs" is now a "child" of folder "SEO Settings".

16. Back at the site, you'll see the document "Google Friendly URLs" is now an item under the heading "SEO settings".

17. And here is a snap shot of how the mark up looks, for anyone planning site navigation it's important to see the folder/child relationship is correctly marked up as below.