What is it exactly ?
Wordpress Theme Toolkit is just a set of 2 PHP files you will drop into your theme directory (see Page 4 for download links)
- themetoolkit.php : the class definition. You'll never need to do anything with it. Put it in the directory, forget about it.
- functions.php : this small file contains the few things you will edit.
So, how easily ?
Ready for a 3 minutes tour ? Let's create our admin menu. Say we are working on a theme named, how original, "My Neat Theme", which would sit in wp-content/themes/mytheme.
- Step 1
Put the required files functions.php and themetoolkit.php in your theme directory. - Step 2
File functions.php looks like this :CODE:-
<?php
-
include(dirname(__FILE__).'/themetoolkit.php');
-
-
themetoolkit(
-
'mytheme',
-
-
array(
-
'option1' => 'Text for Option One',
-
'option2' => 'Text for Option Two',
-
'option3' => 'Text for Option Two',
-
),
-
-
__FILE__
-
-
);
-
?>
First line is where the class definition is included. Nothing to edit here.
Then, a function call with three parameters : themetoolkit(), which is passed a theme name, an array of options, and PHP predefined constant __FILE__. Leave this last parameter untouched, edit the first two to suit your needs.
-
- Step 3
(This step is not required with Wordpress 2.0, but is for WP 1.5 compatibility. Once the whole world will have switched to 2.0, you can just skip it !)
Add this line to your template header.php :CODE:-
<?php include_once(dirname(__FILE__) . '/functions.php'); ?>
Now load your blog with your theme enabled.
-
And that's about it.
And what did that do ?
These three steps produced a few things :
- Now, in the Themes admin area, we have another menu added. Just like a plugin adds a menu, except that this time your theme did the job.
- Let's click on this menu : here is your theme control panel ! The three lines you edited created a menu, nicely integrated within Wordpress admin area, ready to accept some input from theme users. (click image to enlarge)
Now what ?
From now on, everything you will input in the admin menu you've just created will be stored in a array of variables, named $mytheme->option. For example, if you enter in our 3 input fields the values "value1", "43", "some other text", the following array will be available :
-
$mytheme->option['option1'] = "value1"
-
$mytheme->option['option2'] = "43"
-
$mytheme->option['option3'] = "some other text"
What you "just" have to do now is create your own functions, add features to your theme that will use these values the user can input. Look below in section "Examples and Ideas" to see what you could use this for.
Related posts
Page: #1 #2 #3 #4 #5Shorter URL
Want to share or tweet this page? Please use this short URL: http://ozh.in/ko
Metastuff
189 Blablas
Pages: [19] 18 17 16 15 14 13 12 11 10 9 … 1 » Show All
Pages: [19] 18 17 16 15 14 13 12 11 10 9 … 1 » Show All
replied, on 21/Dec/09 at 8:23 pm # :
im a new web designer not good with php and i look for tutorials or some help of how to use wp theme toolkit.
i understand the basics and already have done some stuff with my new theme with it but i still need to do some more things but i cant
so any help plz ?
Thanks
commented, on 27/Nov/09 at 6:10 pm # :
Sorry, I forgot to include to select 'Mac McDonald' as the contact in the form mentioned in my previous post.
thought, on 27/Nov/09 at 6:07 pm # :
I just realized that I am using a modified version of themetoolkit.php that was included with the Simplicity theme by Lai Zit Seng. Lai fixed a bug with an extraneous dollar sign, and corrected some HTML ending tags in version 1.12.
If you will email me using the About->Contact Us form bluegrassmiataclub.com, I will send you this version.
said, on 27/Nov/09 at 5:26 pm # :
This is an awesome tool for me! I have fixed a problem with checkboxes and now have it working under WP 2.8.6.
Here is the modified read_options()
pingback on 07/Sep/09 at 2:39 pm # :
[...] Theme ToolKit [...]
pingback on 07/Sep/09 at 2:39 pm # :
[...] Theme ToolKit [...]
pingback on 07/Sep/09 at 2:39 pm # :
[...] Theme ToolKit [...]
said, on 23/Jul/09 at 7:32 am # :
Hey Ozh,
I known your are a busy person, but if you can bring the tool kit up to 2.8.1 compatibility will be more than great, you will make more people happy ;)
Theres a option to pay for this compatibility? Please let me know, write to my email.
Regards.
commented, on 23/Jun/09 at 3:55 pm # :
@Anil, the Toolkit does not use get_category but a customised one might ;)
You may be running into a WordPress problem here. 2.8 has a known issue with category functions and this has been fixed in 2.8.1, which is currently in beta testing.
See here for more info: http://wordpress.org/support/topic/280256?replies=26#post-1104991
I am running 2.8.1 Beta on some production sites now because of some of the issues in 2.8. You might like to consider doing the same (or waiting a bit for the final release). Try it on a test site first and see if the problem with your Toolkit goes away.