FAQs & Troubleshooting
Last updated Nov 2nd, 2021 | Page history | Improve this page | Report an issue
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
$292 per month—let's make that $500!Learn more
This document aims to get you started with common issues / questions with MODX Revolution by either answering it, or pointing you to the right resources. It is by no means exclusive, and a good search on the forums and this documentation may find more resources for what you're looking for. In all cases - if you can't find what you need, do ask in the forums or on IRC: irc.freenode.org channel: #MODX.
The questions numbering represents nothing but that - a number to indicate what question you're looking at to help scanning through.
This is a documentation stub, and could use your help to complete! If you don't have access to edit this page, please post anything you would want to see added or updated in this topic on the forums.
This document will always be a work in progress as new features are added / changed, and it could use your help in keeping it structured and up to date! If you do not have access to editing this document, please post anything you would want to see added or updated in this topic on the forums.
Table of Contents¶
FAQs and/or Troubleshooting on specific subjects elsewhere:
- Troubleshooting Installation
- Troubleshooting Upgrades
- Troubleshooting Package Management
- Troubleshooting Security
Subpages dealing with specific subjects:
On this page, you will find the following categories and questions:
1. MODX 101¶
1.1. What is MODX Evolution, and what is MODX Revolution? What's the difference?¶
MODX Evolution is the legacy code and are the 1.x versions. It has powered hundreds of thousands of websites in the past five years and is what has shaped MODX.
MODX Revolution is a complete rewrite of MODX Evolution which shares the same ideas but is based on xPDO, a database abstraction layer, and finally saw daylight in 2010.
There are three kinds of MODX products at this point:
- 0.9.6.x – the original code base that started with it's first production/stable release as version 0.9.0 at the end of October 2005. No longer supported, and you REALLY should update to the latest Evolution version. Exploits founds in 0.9.6.x have long been fixed!
- Evolution 1.x – a cleaned up and refined distribution of 0.9.6.x with conventions and terminology more in line with our totally rewritten Revolution release.
- Revolution 2.x – a fully object oriented and completely new branch that's been in development for more than 3 years that addresses limitations found in the original code base such as having a truly recursive parser and eliminating the 5,000 document ceiling.
- "The Evolution of a Revolution" https://modx.com/about/blog/the-evolution-of-a-revolution/
- "What are the basic differences between Evolution and Revolution?" https://modx.com/revolution/product/faq/#q1
- There's a number of big topics on the forums as well discussing evo and revo which may be interesting if you're looking for more in-depth discussing of the differences. As Revolution has been over three years in development, do check out the date something was posted to be sure they are still relevant.
1.2. What different tags can I use? What is
Check out the Tag Syntax documentation. You can find resource fields you can use in Revolution on the Resources Documentation.
2. The Manager¶
2.1. Help! Where did the sidebar go?¶
You probably hid it at some point. There's a subtle arrow on the left side of the screen (see this image) that you can click to bring it back. In some cases you will need to refresh the page for the contents of the sidebar to load properly.
2.2 How can I modify what resource fields are visible when creating or editing a Resource? Is there something like ManagerManager for Revolution?¶
You can use Form Customization (found under the Security menu) to change the fields. It doesn't offer all of the (Evolution) ManagerManager plugin but comes pretty far.
2.3 What does modDocument/ modWeblink/ modSymLink/ modStaticResource mean?¶
They are the class names of Documents, Weblinks, Symlinks and Static Resources. They are "subtypes" of Resources (class name modResource) and each have their own specific goal. They all show up in the Resource Tree and can appear anywhere in the hierarchy.
- Documents (commonly refered to as Resources, see 2.4 below) are regular pages and have content.
- A Weblink redirect a user to a different Resource or an external URL.
- A Symlink acts as a copy of a Document
- Static Resources act like Documents, however their content comes from a file on the filesystem.
2.4 What is the difference between a Resource and a Document?¶
Technically, a Resource (modResource) is an abstract object of which a Document (modDocument) is an implementation.
Practically both terms are used to indicate the same thing: a Document which holds certain content. Coming from the technical implementation, a Weblink, Symlink or Static Resource are also be included when referring to "Resources" as they are also implementations of the modResource class.
2.5 I'm locked out! I can't access the manager! Forgot my password and recovery doesn't work!¶
You're not doomed. Check out these instructions for Revolution.
3. Frontend Display Issues¶
3.1 Blank frontend pages resolved by Clearing Cache¶
In Revolution 2.2.5 the way xPDO/MODX write cache files has been re-factored. If you are having issues with blank frontend pages that are resolved after clearing the site cache, you could try setting use_flock. This should help with RackSpace Cloud hosting, GoDaddy hosting, and some other providers.
Also, if after saving a resource/template the browser only gives an error message 500 when loading the manager. And if the problem can then be solved by deleting the entire cache directory content via FTP, then this indicates a flock issue.
In your MODX config file add the setting use_flock in your $config_options array, and set it to false.
See Original Post: http://forums.modx.com/thread/78611/core-cache-file-locks-and-will-not-update#dis-post-434053
3.2 General Snippet Problems¶
If you find a snippet and/or plugin isn't working properly despite the correct code, double check that it has been installed.
4. Frontend Display Issues¶
4.1 Blank manager pages¶
Perhaps the most complete list of what needs to be checked is described here: https://community.modx.com/t/blank-manager-with-undefined-message/3799/20