A documentation and demonstration site for concrete5 addons and themes by JohntheFish. (For concrete5.6 addons and documentation, please see legacy.c5magic.co.uk. For underwater photography see jlunderwater.co.uk.)
I build web sites using the open source concrete5 Content Management System. Using a good CMS is the way to future-proof a web site and concrete5 leads the way in usability, both for site owners and site developers. I offer pretty much anything from complete sites to emergency repairs, specialising in advanced development as a service to projects and for my own portfolio of addons.
I offer pretty much anything from complete sites to emergency repairs, specialising in advanced development as a service to projects and for my own portfolio of addons. I balance this with my other business as an underwater photographer and journalist. Web and diving work provide a good balance between home and away, especially with global communications.
I have used many of the concrete5 add-ons I have developed to facilitate the process of building this site and have generally used this site to showcase my addons wherever I can. Having the right tools to hand makes creating a site easier, faster, reliable and maintainable.
With the right tools, it doesn't take long to have a web site up and running. Of course, there have been subsequent changes as I add more support pages for my addons, but hopefully you get the general idea and by using a CMS the updates are easy to stay on top off. When it does come to updates, with the right tools you can make changes easily and safely.
I like making concrete5 add-ons that are the easy for others to use. Easy user interfaces. Easy to understand. Easy to grasp the concept of. Things that make an otherwise difficult job easier.
Where that isn't possible, documentation and examples need to fill the gap. A unique function of many of my addons is the ability tofrom an example on this site, copy and import them into the addon on your own site. That way even relatively complex capabilities can be made easier by providing a starting point.
To maintain these addons I use Package Magic to analyze the code, bundle them up and upload to this site. Its a fact of life. Developers make mistakes. I make mistakes. Using the right tools minimizes those mistakes and helps us fix them.
The tabs on this page use Magic Tabs, an add-on that chops a page into tabs simply by inserting a block where each tab is wanted. It comes back to one of my opening comments. Magic Tabs is easy to use, but behind the scenes has some intricate engineering so that site builders can simply get on with their work without worrying about the code behind it.
Also used throughout this site is Button Nav to provide supplementary navigation and information, Syntax Anywhere for code samples, Universal Content Puller for many places where content needs to be duplicated between pages or pulled in from elsewhere, Omni Gallery for image galleries and sliders and Last Updated to show when main content has been changed. A site maintenance task that is now safely automated.
Behind the scenes, I use Extreme Clean to remove the hidden bloat of obsolete data that web sites accumulate, keeping things running smoothly and making sure such housekeeping maintenance is not neglected. I also leave notes to myself using Editor Comment, so that when I come back to a page to edit again I have a record of previous decisions, good and bad.
Searching on this site is powered by Search++, an enhanced search system I developed to break out from the extreme literal pitfalls of the default concrete5 search. Give it a try and see how it compares to searches on other concrete5 sites.
I am not a theme designer in the graphic sense. If all you are looking for is an original theme design, there are theme designers who have a better eye for a new theme design than I do.
So why am I writing about design? For a web site, design cannot be independant of engineering. Behind a theme design you need good engineering. There are some beautiful Concrete5 themes out there with, behind the scenes, mediocre engineering. There are also some with excellent engineering. I can take a graphic design and turn it in to a thoroughly engineered theme. To put it simply, build a theme into a site that works, that will carry on working, and that a site owner can confidently use.
The theme used through most pages of this site is Elemental, the default concrete5 theme, supplemented by Frontend Dashboard, a theme that makes front end pages follow the concrete5 dashboard theme.
Many of my concrete5 add-ons help put the finishing touches to a design. My general principle is to provide front end styling that inherits from your site theme as far as possible.
Button Nav is an easy way to add styled buttons to a page with dropdown, dropout and popup functionality. Many of the templates provided by Magic Tabs assume styling from the site theme, so in many cases you don't need develop custom templates (and when you do, the examples are easy to follow). Both provide easy ways to extend the site theme without having to get inside the theme files
All the bits and bobs a site is built from need to be documented so the site can be maintained in the future. The way a site is built is not something to be done once and forgotten.
With addons and themes for concrete5, their use needs to be clearly explained and documented so site builders and developers know what they are installing on their site and how to use it effectively.
The principle of commenting code also applies to web site pages. Within pages my Editor Comment block can be used to keep notes about how and why a page is structured, hidden from general view, but always there next time a page is opened in edit mode.
Whether its an entire web site or an addon for concrete5, it will need supporting.
My engineering principles mean that you should be able to do much of this yourself. Nevertheless, there are times when help will be needed and my commitment to support is part of the process. Where support has been needed, my support and solutions are consistently fast, as testified by many of the reviews for my addons.
Take a look at karma and badges earned within the concrete5 community. These are a measure of support, promotion and development (much of which is supporting development).
On a more general level, I help others out on the concrete5 Forums and Slack, have written some useful how-to's for concrete5 and am an administrator of the Peer Review Board, the group of developers that makes sure new concrete5 add-ons and themes are up to scratch. I have even written a how-to to help others Get marketplace submissions through the PRB.
Manually Installing an Addon or Theme
Perhaps you are unable to connect your site directly to the ConcreteCMS marketplace to install an addon or theme. This manual process works for all addons and themes - not just mine.
- In your concrete account, find the addon/theme in your Purchase History > Licenses and download. Make sure to scroll down to the most recent version before downloading.
- Then copy the zip to your site /packages/ directory and unzip (not /concrete/packages !!!). This is usually easiest using your host cPanel file manager.
- In your site, visit the Dashboard > Extend page and the theme package will be ready to install.
The process is exactly the same for addons and themes, except themes have an extra step of activating the theme after installing.
Sometimes step 3 above can run out of PHP execution time. This is most likely when installing an addon or theme that installs a large amount of sample content. You should not run into such an issue with any of my addons or themes.
If you do run into such issues, you can run the install manually from the shell command line.
If you find yourself needing to install or update many addons or themes manually, consider my Package Magic addon.
Once Package Magic Starter is installed, through the marketplace or manually, all further installs can be handled from the site dashboard using Package Magic.