| 1 |
THEME SETTINGS API
|
| 2 |
|
| 3 |
This module simply extends the Custom Theme Settings API documented in the
|
| 4 |
Theme Developer's Handbook: http://drupal.org/node/177868
|
| 5 |
|
| 6 |
In the Drupal administration section, each theme has its own settings page
|
| 7 |
at admin/build/themes/settings/themeName where you can configure standard
|
| 8 |
settings like "Logo image settings" and "Shortcut icon settings."
|
| 9 |
|
| 10 |
You can make your theme customizable by adding additional settings to that
|
| 11 |
form using the Custom Theme Settings API.
|
| 12 |
|
| 13 |
Currently, this modules only adds the optional ability to switch to the theme
|
| 14 |
whose settings are being edited. Once this module is installed, see the
|
| 15 |
admin/settings/admin page.
|
| 16 |
|
| 17 |
Improvements to the Custom Theme Settings API are slated for the 6.x-2.0
|
| 18 |
version of this module.
|
| 19 |
|
| 20 |
ABOUT THE PROJECT
|
| 21 |
|
| 22 |
In Drupal 4.7 and 5, it was impossible for themes (like PHPtemplate-based
|
| 23 |
ones) to add settings to the theme settings page without coding a module.
|
| 24 |
There needed to be an API to facilitate that. No one had successfully
|
| 25 |
implemented this (See issues 54990, 56713 and 57676.)
|
| 26 |
|
| 27 |
The Theme Settings API project created a fully functioning implementation of
|
| 28 |
a custom theme settings API for Drupal. This API should reside in core and
|
| 29 |
this project successfully championed the addition of an updated API into
|
| 30 |
Drupal 6 (see issue 57676 at http://drupal.org/node/57676.)
|
| 31 |
|
| 32 |
The new goal of the project is to continue to improve the API and get those
|
| 33 |
improvements into Drupal 7.
|