Quill is a sleek, modern and clutter-free blog theme for MODX that offers a more immersive reading experience. In just a few clicks, you'll have a fully functioning blog—thanks to MODX package dependencies.
Quill is a One-Stop blogging solution for MODX that's designed to quickly get you in writing mode. By taking care of the heavy lifting, it allows you to focus on what matters most to you: Publishing your thoughts.
Installand follow the instructions.
Bravo! You now have a fully functioning blog themed by Quill.
To take full advantage of Quill's features, let's quickly customize it:
Head over to
Extras > Configuration and make all necesary changes. Typically, you'll need to update the following settings:
Additional settings are available in
System Settings. And, yes, you can start blogging already.
Quill is light as a Flight Feather and since it's extremely obsessed with staying out your way, it installs its basic resources in a dedicated container. This minimizes any chance of name conflicts with other resources you may already have in your site tree.
Because Quill's global container is only used to group its basic resources, it is not required in your blog setup. You should move Quill's basic resources to the top level of the site tree and delete the global container once you've resolved any name conflicts you may have.
Quill ships with one template and, by default, blog posts use the
Blog Postlayout. You can choose other layouts from the
<!DOCTYPE html> <html lang="[[++cultureKey]]"> <head> [[$qllHead]] </head> <body> [[$qllNavbar]] [[*qllPageLayout]] [[$qllFooter]] [[$qllScripts]] </body> </html>
Layouts are stored in chunks (inside the
QuillLayouts category). Customizing the default layouts is a walk in the park—the markup is clean, intuitive and well-structured. You can add new layouts as needed. Just don't forget to update the
Page Layout TV.
When you're writing long articles, tutorials or other content-heavy material, chances are that you want to start writing as soon as you click New Post. And if unneeded resource fields get in the way, you can hide them—thanks to Manager Customization.
We can take this a step further and apply the same logic to the Posts Grid View:
These customization sets are not built-in. You'll need to import and activate them manually. It's super easy:
Manager Customization(Under the gear icon)
Import New Set from XML
A copy of sample sets is available in the
Once imported, make sure to change any occurence of
[[++quill.blog_container]] with the id of your blog's landing page (named Blog by default). Feel free to update those rules as needed. When done, click
Save again to activate the changes.
You've probably noticed the
Page not found and
Site unavailable resources in the site tree. They should be automatically set as your site's defaults when Quill installs. To set or update their settings manually:
System Settings(Under the gear icon)
Search by keysearch field, enter
valuefield and enter the id of the
Page not foundresource. Only update the one under
valuefield and enter the id of the
Site unavailableresource. Again, only update the one under
Bravo! You've Quillified your error pages.
Quill is built on top of Bootstrap V4 (alpha). Naturally, all your favourite Bootstrap component and element styles will be available for you to use. But, Quill goes beyond the basics by extending Bootstrap and adding some custom styles of its own—making it a truly distinctive theme.
Head over to the Pattern Library for the complete style guide and feature list.
You shoudn't really need to modify anything in the
/style/vendor/ (mainly Bootstrap). Use
@imports instead on the primary stylesheet (As we have). Quill's
/style/_variables.scss partial overrides Bootstrap's default variables. You can use it and the other partials for further customizations.
Writer, this is it! I hope this quick Flight Manual will get you up and running with Quill quickly. Now go out there and inspire us with your captivating thoughts.
Quill wouldn't be possible without these very useful assets:
Special thanks to MODX's John Peca (@theboxer) and Wayne Roddy (@dubROD) for the groundwork. Flatso theme and Git Package Management were invaluable when developing Quill. Shout-out to @donshakespeare for intensively testing out Quill's initial Beta release.