Hotaru Docs tools: Log in / create account
Hotaru itself doesn't have many templates in its default theme. That's because plugins extend Hotaru by providing their own templates.
Wouldn't upgrading a plugin overwrite template customizations?
Yes. This is a problem with most CMS plugin systems. Take Wordpress for example. If you edit a plugin, you're going to lose those edits when you upgrade that plugin.
In Hotaru, if you've customized a template in a plugin, e.g. bookmarking_post.php in the Bookmarking plugin, you'll lose your edits if you upgrade. Fortunately, most customization will use CSS, so you shouldn't need to physically edit the template files anyway. Of course, if you do make edits, you'll need a workaround...
Note about CSS: In the default theme's header.php template, plugin files are included before a theme's style.css file. Therefore, the latter takes precedence over any css files included from plugins.
Before looking in the plugin folder for a template, Hotaru looks for it in your theme folder. That means you can copy a template from a plugin into your theme folder, keeping it safe from any unwanted upgrades. When new versions of plugins become available, you can simply compare your existing template to the new one and copy any new features into it.E.g. Copy a plugin template from
Hotaru doesn't just look in your theme folder before the plugin folder. Let's imagine Hotaru is looking for the bookmarking_post.php template that comes with the Bookmarking plugin. Here's what it does:
That means you could put the templates in the default theme and change your theme without having to copy any more files.
Here's how Hotaru finds the language it needs:
That means you can copy all the plugin language files to your own language folder.
Here's how Hotaru finds the css it needs:
That means you can copy all the plugin css files to your own css folder.