Download & Extend
Advanced help » Issues

Supports themes?

Posted by momendo on March 14, 2009 at 1:19pm
Project:Advanced help
Version:6.x-1.x-dev
Component:Documentation
Category:feature request
Priority:major
Assigned:Unassigned
Status:needs review

Issue Summary

This is a general question. Does this module or the patch going into D7 let themers write documentation for themes?

Login or register to post comments

Comments

#1

Posted by merlinofchaos on March 15, 2009 at 3:14pm

Currently only modules are checked for help files, but this could easily be extended to themes.

#2

Posted by thekenshow on May 14, 2009 at 1:23pm

I agree – theme support is a terrific idea. I was thinking about documenting my experience with various aspects of the Zen theme and immediately wondered how to use Advanced Help for this.

#3

Posted by stephthegeek on June 15, 2009 at 2:17am

Definitely +1. We make some complicated themes, would love to have a Drupally way to document things inside the theme itself :)

#4

Posted by merlinofchaos on June 15, 2009 at 3:40am

I was totally wrong

// Search paths:
$paths = array(
path_to_theme() . '/help', // Allow theme override.
drupal_get_path('module', $module) . "/translations/help/$language->language", // Translations.
$info['path'], // In same directory as .inc file.
);

So there you go.

This only really allows overrides, though. Actually having help *for* a theme might be trickier, though not completely impossible. I'm not sure if what's in there is enough so not yet marking fixed, though if it is sufficient for folks, go ahead and do so.

#5

Posted by fgm on June 6, 2010 at 4:56pm
Status:active» needs review

This patch seems to add theme support. Use just as in modules: help directory in the theme, (theme).help.ini file, and pages.

AttachmentSize
help_themes.patch 1.02 KB

#6

Posted by fgm on June 10, 2010 at 9:55am

Revised patch includes revision of the help text.

AttachmentSize
help_themes.patch 20.89 KB

#7

Posted by Zach Harkey on December 23, 2010 at 7:46pm
Priority:normal» major

+1 This is huge!

@fgm: Thank you! The patch works great.

Also, I hope it's ok if I change the priority of this feature request to major, because this really is a huge deal for theme developers.

This finally makes it possible for the theme to easily provide deluxe style guides, code snippets, image and graphic specifications, best practices, how-to videos, etc.

#8

Posted by BrightBold on June 7, 2011 at 3:22pm

Anyone willing/able to port this patch to D7? I'd love to test it out by creating theme documentation, but all the new sites I'm developing are in 7. I agree that this will be an amazing benefit for theme developers and, more importantly, for content administrators who will be able get help on themes, so I'd love to help test and get it committed.

#9

Posted by nerilka on October 19, 2011 at 7:46am

suscribe

#10

Posted by fgm on October 20, 2011 at 9:28am

@nerilka: please no longer use comments to subscribe to issues on d.o.: click the "Follow" button on top of the issue instead.

#11

Posted by esmerel on December 6, 2011 at 3:00am

Funny that stephthegeek asked me about this very thing today. I bet she forgot that she's asked for it once already! =-)

#12

Posted by fgm on December 7, 2011 at 6:51pm

Now if anyone would commit that patch, or at least RTBC it so I can commit it...

nobody click here