There should be a note (or even multiple) about the expected format of filenames in the examples for HOOK.vars.inc and OWNER.theme.inc: HOOK and OWNER, just like .tpl.php files, need to have underscores replaced with dashes, otherwise they won't be loaded anymore when disable_theme_caching is set to 0 (i.e. when switching to a live environment). As long as caching is disabled (i.e., during development), hexagon blindly loads all include files on each request, even the malformed ones, so it seems to work, but causes headaches when finally enabling the cache.

Comments

marcp’s picture

Documentation for theme function files (ie. comment-submitted.func.inc to hold your theme_comment_submitted() function) would be great too.

Maybe this documentation is in the 7.x branch? I haven't looked there!

dvessel’s picture

Marc, there are examples within “A_STARTER_THEME/overrides/examples” in the 6.x branch. There are also examples in 7. The documentation is not completely there though.

smk-ka, this issue fell off my radar. Sorry for the late reply. I’m aware of the inconsistent loading behavior and it’s been rewritten in the 7 branch and is no longer an issue. It is now very specific and doesn’t blindly load when caching is disabled. I’ll make sure the naming conventions are written in the docs.