1. Getting Started
      1. Basic Installation
      2. What is MODx
    2. Content Editing
      1. Editing Documents
      2. MODx Tags
        1. Document Variables
      3. Terminology
      4. The Manager
      5. Who Should Read This
    3. Designing
      1. Adding Chunks
      2. Adding MODx Tags
        1. Resource Fields
      3. Adding Snippets
      4. Document Caching
      5. Template Basics
    4. Administration
      1. Friendly URL Solutions
      2. Manager Users
        1. Manager Roles And Groups
        2. Reset your Password - Unblock your User
        3. Why Manager Users, Roles and Groups
      3. Moving Site
      4. Taking sites down for maintenance
      5. Upgrading
      6. Web Users
        1. Creating a Web User
        2. Web User Groups and Document Groups
        3. Why Web Users and Groups
    5. Developer's Guide
      1. API Reference
        1. DBAPI
          1. delete
          2. escape
          3. getInsertId
          4. query
          5. select
          6. update
        2. Document Object
        3. DocumentParser Object
          1. addEventListener
          2. changeWebUserPassword
          3. documentContent
          4. documentGenerated
          5. documentIdentifier
          6. documentListing
          7. documentMethod
          8. documentObject
          9. getAllChildren
          10. getCachePath
          11. getChildIds
          12. getDocumentChildren
          13. getDocumentChildrenTVarOutput
          14. getDocumentChildrenTVars
          15. getLoginUserID
          16. getLoginUserName
          17. getLoginUserType
          18. getManagerPath
          19. getParent
          20. getParentIds
          21. getUserData
          22. hasPermission
          23. isBackend
          24. isFrontend
          25. logEvent
          26. maxParserPasses
          27. minParserPasses
          28. regClientCSS
          29. runSnippet
          30. table_prefix
          31. tstart
          32. webAlert
      2. Chunks
      3. Modules
        1. How to create and run a module from within the Content Manager
        2. Managing module dependencies
        3. Setting up configuration parameters
        4. Writing the module code
      4. Plugins
      5. Snippets
      6. Template Variables
        1. (at) Binding
          1. (at)CHUNK
          2. (at)DIRECTORY
          3. (at)DOCUMENT
          4. (at)EVAL
          5. (at)FILE
          6. (at)INHERIT
          7. (at)SELECT
          8. What are (at) Bindings
        2. Creating a Template Variable
        3. What are Template Variables
        4. Widgets
          1. Misc. Widget
          2. DataGrid Widget
          3. Floater Widget
          4. Hyperlink Widget
          5. Marquee Widget
          6. RichTextBox Widget
          7. Ticker Widget
          8. Viewport Widget
          9. What are Widgets

The Manager

Welcome to the MODX Documentation. It is an ongoing effort of the MODX community. If you would like to participate or if you notice any errors or missing content, please let us know.

Logging On to the Manager

To login to your site's Manager:

  • Go to your website, by entering your domain name then "/manager/" eg www.yourdomain.com/manager/
  • Enter your username and password to login to your website's administration page.

To change your password:

  • After you have successfully logged in to the manager you can change your password.

To logout:

  • In the Admin Menu in the upper right of the page click on Logout.

Introduction to the Manager

The Manager area is divided into 3 areas

  • Top: Main and Admin Menus
  • Left: Resource tree
  • Right: Main Manager Area

Additionally there is a floating panel with some action buttons. The type off buttons change according to the mode the manager is in (editing content, managing users and so on). The floating panel is always positioned at the top of the main manager area.

You can resize the left-hand area by dragging the middle bar (marked green in the screenshot) left or right. [The layout can also be configured differently by the site administrator]

What is the resource tree?

This is a list of all the resources (e.g. pages, weblinks) in the website, arranged in a hierarchical order. This is where you select the resources you want to edit, move or delete.

The number in parentheses on the right of each resource's title is the document ID. There may be occasions when you will need to know a resource's ID. This is where you find it.

You can use the resource tree icons to perform actions on the tree. Hover your mouse cursor over the buttons for tooltips to explain their purpose.

Are there any shortcuts?

Yes. You can right-click on a resource's name in the resource tree to access the contextual menu. The contextual menu gives you quick access to additional shortcuts. If you prefer left-clicks, you can open the same contextual menu by left-clicking the resource's icon wich is always shown left of the resource's name.

  • You can create resources and weblinks in an existing resource/container (a resource which has children is called "container" within MODx), by right-clicking on the resource/container and selecting one of the "Create ..." items in the list. This saves time moving the item from the first level after you have created it. If the container resource had no children before, it will automatically be changed to a container.
  • You can go directly to the Edit page of a document, without having to open the document first.

Uploading content

You can upload content (e.g. PDF files and image files) using FTP or the MODx inbuilt File Manager. Images can also be uploaded using the Image icon on the document editor toolbar.

If you are using FTP, you should transfer files to the appropriate folder in the /assets folder. For example:

  • Transfer images to the /assets/images folder.
  • Transfer pdf and text files to the /assets/docs folder.

Upload files and images with File Manager

To upload files and images:

  • Click on Manage Files in the Admin menu. The File manager will open.
  • Click on Browse to locate your file on your local PC, then click Upload file.

Editing webpages

To update existing content on the site you need to:

  • Locate the web page (called a document) in the document tree.
  • Click on the document's name, or right-click and select "Edit document"
  • Open the page to edit.
  • Edit the page with the WYSIWYG editor.
  • Save the page.
  • Check in the Preview.

How do I preview on the live site?

Click on Preview on the Site main menu item.

Or keep a web page with the live site open in another window or browser tab. Then you can just refresh the page to view any changes. In Internet Explorer use CTRL + F5 if the menus don't appear correctly, or new content is not showing. If you are still having problems viewing new content, clear the server cache, by clicking on Clear Cache in the Site main menu item.