WordPress Theme Toolkit

In every WordPress theme there are places that are supposed to be edited and customized by the end user who is using the theme : an "About you" block to fill in, a loop to customize when you want to add "Asides" post style, some CSS to tweak to use an personal image in header, etc…

The problem is : most bloggers are not PHP or HTML expert, can't tell the difference between an HTML tag and a PHP tag, and simple editing of templates can be hazardous and tedious to them. Adding an admin menu in your theme ensures that end users can customize things without editing source files, just as naturally as changing a WordPress option in the admin area.

WordPress Theme Toolkit is a PHP class that gives WordPress theme authors the opportunity of creating a persistent admin menu for their theme as easily as editing 3 lines in a file.

You are a theme author ? Have enough skills to edit three lines ? Add an admin menu to your theme ! (click to enlarge)
Theme Toolkit : admin menu example

Just to be sure : WordPress Theme Toolkit is not a theme with an admin menu. It is something that makes adding an admin menu to an existing theme as easy as 1-2-3.

This long article is divided in shorter sections :

  1. Intro : well, here.
  2. Overview : a quick tour about features and how easy things are.
  3. Manual : detailed features and how-to
  4. Download ! : files and credits.
  5. Ideas and Examples : suggestions and ideas of what you could add to your theme … and a real WordPress Theme as an example of use.

196 comments

  1. WordPress Theme介绍(三):Fauna at iqwolf

    […] 说Fauna内秀是因为它使用了Ozhçš„WordPress Theme Toolkit:WordPress Theme Toolkit是一款为主题设计者开发的插件,它允许设计者为自己的作品添加丰富的自定义选项,从而满足用户的不同需求。无论是否具备XHTML或CSS的相关知识,用户都可以通过“Current Theme Options”轻易的完成网页图片的更换、模版布局的调整以及背景色彩的修改等基本操作。而这篇文章的主角则是最能体现WordPress Theme Toolkit精髓的一款主题,可以说是Fauna放大了这个插件的作用。 […]

  2. Theme Toolkit

    […] Hablando de temas para WordPress: Theme Toolkit. Archivado en: CMS diseño web minipost WordPress […]

  3. WordPress Themes 设计手记(五) at Xu Yiyang

    […] 贫僧先来介绍一下今天的主角——Wordpress Theme Toolkit å’Œ Unnamed 0.4.1:Wordpress Theme Toolkit 是著名 WordPress 达人 Ozh 开发的专用于编写 WordPress 模板后台管理页面的工具(Ozh 开发了很多经典且实用的WordPress插件和工具,施主可以在这里找到更多好玩的东西)。尽管已经有很久没有更新,但经过测试,发布于九个月前的、将该工具性能压榨殆尽的 Unnamed 0.4 至今仍能非常稳定的工作在 WordPress 2.3-Alpha 平台下。 […]

  4. DP

    Are you cool with modifying your code? I noticed a couple of people wanting to add cases to it. I will be redistributing it, but will leave attribution intact. It's not for profit.

  5. Ozh

    I'm pretty cool with this indeed :)
    Please leave attribution intact so that people know where to refer for the original documentation etc, and change the version to something like "1.2+dick" or whatever to clearly identify the fork : I don't want any support request regarding your modifications :)

  6. Infected-FX » Estrenamos diseño

    […] Theme Toolkit – Configuración del theme […]

  7. Estrenamos diseño | Infected-FX| tutoriales, photoshop brushes y recursos para diseñadores web

    […] Theme Toolkit – Configuración del theme […]

  8. WordPress | Spiga.com.mx

    […] WordPress May 31st, 2007 Dentro del desarrollo web Spiga ha ganado gran "expertise" en el manejo de una de las más utilizados plataformas de administración de contenidos conocida como WordPress. Utilizando esta plataforma y las diversas herramientas que ofrece como widgets logramos generar una interfaz gráfica (GUI) donde el usuario final tiene la posibilidad de modificar aspectos gráficos, estructurales y funcionales del sitio sin necesidad de conocimientos de programación usando Theme ToolKit. […]

  9. WordPress Widgets | Infected-FX| tutoriales, photoshop brushes y recursos para diseñadores web

    […] intentando, de entrada he podido generar dos themes usando los widgets y uno de ellos mezclado con WordPress Theme Toolkit que hasta el momento ha sido una herramienta a la que le he podido sacar mucho provecho y tiene un […]

  10. steffen

    hi, is there a way to show a second admin tab?

    nice toolkit btw. :)

  11. Ozh

    Steffen » never tried. You could try to duplicate everything (themetoolkit2.php with class themetoolkit2), should probably work.

  12. steffen

    thx, i try it.

    can i use php-code in the textarea? how i have to show it?

  13. 数据恢复

    WordPress May 31st, 2007 Dentro del desarrollo web Spiga ha ganado gran “expertise” en el manejo de una de las más utilizados plataformas de administración de contenidos conocida como WordPress. Utilizando esta plataforma y las diversas herramientas que ofrece como widgets logramos generar una interfaz gráfica (GUI) donde el usuario final tiene la posibilidad de modificar aspectos gráficos, estructurales y funcionales del sitio sin necesidad de conocimientos de programación usando Theme ToolKit. […]

  14. nyssajbrown.net | WordPress Theme: Simple In Pink 0.2

    […] been working on getting Simple In Pink up to a better standard. I decided to use planetOzh's WordPress Theme Toolkit to add some theme options. Simple In Pink has an "About" box on the front page. […]

  15. digg review wordpress blog

    I liked your WordPress Theme Toolkit. Just what I need to help me revamp my blog.

    Thanks!

  16. antiblau blog » Von der Schwierigkeit ein passendes Theme zu finden

    […] schön schlank und lässt sich sogar noch direkt im Admin-Bereich ein wenig anpassen dank WordPress Theme Toolkit. Dazu kommt, dass die Farben sogar zum Namen des Webservers passen, was will man […]

  17. nyssajbrown.net | WordPress Tips & Tricks: Author Highlighting through Theme Options

    […] an updated version of the Simple In Pink theme, I decided to play around with planetOzh's WordPress Theme Toolkit, to try and add a few options into the theme, so anyone that wanted to use the theme, […]

  18. 灌装机__灌装机技术

    I try it .good!

  19. Plugins que no pueden faltar en tu WP | Infected-FX

    […] Theme ToolKitSin duda uno de los mejores plugins que he encontrado, pueden facilitar mucho las cosas para el usuario final añadiéndole parámetros dependiendo de las necesidades […]

  20. Minyx 2.0 » Storelicious » Premium Themes para WordPress, phpBB y otros

    […] Theme ToolKit […]

  21. Minyx 2.0 | Infected-FX| tutoriales, recursos y referencias para desarroladores y diseñadores web

    […] Theme ToolKit […]

  22. ladynada

    Hi,
    how do you avoid conflicts with themes that already have options? I get the dreaded headers already sent with the WP-Andreas09 2.1 theme because it has the color options and reloads the same page with an & option.

    thanks,
    nada

  23. Ozh

    ladydana » don't know this theme in particular, but it depends how theme authors implement menus. You should discuss this with the theme author.

  24. SEO Blogger

    Hi, I've tried to create other theme sub-menus to break down the options for "Theme Config," "Menu Config" & "Ads Config" (by saving the themetoolkit.php as menutoolkit.php & creating a new themetoolkit function as menutoolkit function, etc…).

    Anyway, I have successfully create the 3 theme sub-menus (Theme Configuration, Ads Configuration & Menu Configuration). However, every time I tried to save a configuration for one of the configurations, the other two default options becomes "empty," thus messing up the theme.

    Anyway, was wondering if you can give some pointer on how to "Save Options" for one and not delete the other options.

    ~The SEO Blogger~
    P.S. I'm still digging the themetoolkit =P. I just want to take it to another level (by having separate/organize/short/no-scroll theme config menus for my SEO theme =).

    …Of course, i can take the easy way out and have the user of my theme fill in all the 100+ options in one lonngggg sroll before "Save Options" (I'm using it for the whole style.php, so you get how long that is !)…

    Anyway, please send me an email (with the answer ;) if you have some time.

    Thank you.

  25. SEO Blogger

    Hmn… I'm thinking it's the plugination & deplugination functions… Well, I'm not a php programmer so…

    Anyway, I did create an adstoolkit.php & ads-functions.php (for the Ads Configuration menu layout), a menutoolkit.php & menu-functions.php (for Menu Config options page) and, of course, themetoolkit.php & functions.php (for general Theme Config options).

    Add these lines into the respective __-toolkit.php file to create the theme sub-menu pages:

    1. add_theme_page('Configure Ads', /*$this->infos['theme_name']*/'Ads Configurations', 'edit_themes', 'ads-functions.php', array(&$this,'admin_menu'));

    2. add_theme_page('Configure Theme', /*$this->infos['theme_name']*/'Theme Configurations', 'edit_themes', 'functions.php', array(&$this,'admin_menu'));

    3. add_theme_page('Configure Menu', /*$this->infos['theme_name']*/'Menu Configurations', 'edit_themes', 'menu-functions.php', array(&$this,'admin_menu'));

    I also changed every instant of the themetoolkit() function to the respective functions:
    1. adstoolkit()
    3. menutoolkit()

    *Also, I add the

    if(function_exists('themetoolkit') themetoolkit (
    'mytheme',
    array(

    *so when I don't have the themetoolkit.php installed, it doesn't throw the error.

    Anyway, I hope I've asked good enough questions and given you enough information (so you can help =)…

    Thanks again for the themetoolkit ;)…

    ~The SEO Blogger~
    a.k.a WorldWiseWebDesign(er).com
    –as the result of the themetoolkit!

  26. Deluxe Cars | Infected-FX| tutoriales, recursos y referencias para desarroladores y diseñadores web

    […] Theme ToolKit […]

  27. Infected

    Hi Ozh! I have a doubt, in your example (asides) How can I get the name of the category? is for reuse in another loop.

    I hope you can help me.
    Regards ^^

  28. Ozh

    Infected » Sorry, I dont get the question

  29. Infected

    Ozh Hello again, thank you for responding, for example in the "panel" user writes category "Asides" How could I get that value the user typed to use for example:

    1. WP_Query("category="the_value_users_write"&showposts=1");

    Thank you again :)

  30. Ozh

    Infected » Well, it's just as explained in this page: use something like $mytheme->option['asides']

  31. Infected

    Oh! thank you Ozh!! You're right.
    :$ Sorry, I had not seen ^^

  32. ????wordpress?? » Freerainbow » Blog Archive

    […] ???????????——Wordpress Theme Toolkit ? Unnamed 0.4.1?Wordpress Theme Toolkit ??? WordPress ?? Ozh ???????? WordPress ????????????Ozh ???????????WordPress?????????????????????????????????????????????????????????????? Unnamed 0.4 ???????????? WordPress 2.3-Alpha ?????? Theme Toolkit ?????? […]

  33. sohbet

    thank

  34. WordPress Portfolio » Blog Archive » Deluxe Cars

    […] Theme ToolKit […]

  35. WordPress Portfolio » Blog Archive » Minyx 2.0

    […] Theme ToolKit […]

  36. My Today’s Diigo 05/23/2008 « Rif.wp memo

    […] WordPress Theme Toolkit « planetOzh […]

  37. Coffee Time » Storelicious» Premium Themes for WordPress

    […] Theme ToolKit […]

  38. WP Folio XL » Storelicious» Premium Themes for WordPress

    […] Theme ToolKit […]

  39. Deluxe Cars| Amazing WordPress Portfolio Theme| WordPress Portfolio

    […] Theme ToolKit […]

  40. Coffee Time | Infected-FX

    […] Theme ToolKit […]

  41. Motti

    Just wanted to say thank you for that wonderful Kit.

  42. Braincast » Storelicious» Premium Themes for WordPress

    […] Theme ToolKit […]

  43. RodeWorks » WordPress Theme Toolkit

    […] WordPress Theme Toolkit « planetOzh […]

  44. Nuevo Theme para mi blog | Omar Corrales Blog

    […] pensado liberar el theme WP-Resurrection pero como queria añadirle algunas opciones intente usar WordPress Theme Toolkit pero tuve algunos errores con el y la verdad no soy tan experto en PHP como para arreglarlo. […]

  45. The P! Company – iamnotagoodartist

    […] their latest sketch shoved down the throat of their visitors. With some help from planetOzh's Theme Toolkit, I put together a YouTube embed box that can be easily changed from the admin […]

  46. Agregar Opciones a tus themes | Omar Corrales Blog

    […] Theme Toolkit Puede ser el mas conocido de todos, Lo use en versiones anteriors de wordpress, pero ahora me da error. Puede ser por mi poco conocimiento de PHP, pero es muy bueno! […]

  47. cet

    i cant do it.

  48. Minyx 2.0 – Theme Wordpress — Simplemente… Nebel

    […] Theme ToolKit […]

  49. wpblogger

    That's great, I have been looking for the solution, found here finally, thanks.

  50. Author description outside the WP main loop – Academic Lozbo

    […] also seems quite interesting, and helped me in my original attempt to display this info using the Planet Ozh WordPress Theme Toolkit functions file (I may talk about the Theme Toolkit in a following article or tutorial in this […]

Leave a Reply

Your email address will not be published. Required fields are marked *