Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.
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
Comment #1
marcp CreditAttribution: marcp commentedDocumentation 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!
Comment #2
dvessel CreditAttribution: dvessel commentedMarc, 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.