Well that took less time than expected XD
Disclaimer: I'm far from knowledgeable in php. This tutorial can be followed by pretty much anyone, as it does not involve any complicated changes to the script, so long as you are familiar with HTML and CSS (experience with editing or making WP themes is helpful, but not necessary). If someone else knows of a better way to do this, or a more correct way, please do share! Or if you can explain it in a less convoluted manner ;)
Using Iconish with Wordpress:
This is a mini-tutorial/walkthrough that will allow you to a) use Iconish within a WP page, and 2) display categories (and subcategories at will) in a sidebar. Example of its use: http://www.fifteenth-moon.net/test/iconish-in-wp/
Things to note: This was written using 3.3, and only tested in 3.3 and 3.3.1, with "pretty" permalinks. Using the default permalink setting (?page_id=#) WILL NOT WORK using this tutorial. Additionally, some of the WP functions I refer to may be old or on their way to deprecated. My page templates are based on and edited from those of the default Kubric-based theme.
Regarding categories, while you technically *can* have subcategories of subcategories in Iconish, doing this with WP will not only throw off your icon count, but also display multiple instances of the same icon in a row (guess how I figured that one out ;)).
This is only for displaying icons in a WP page; you will still have to upload icons and create new categories using the Iconish admin panel.
USING ICONISH WITHIN WORDPRESS PAGES
Step 1: Set up a new directory on your server for the script to reside (name it something different than what you plan on naming your page slug if you're using "pretty" permalinks like example.com/icons/). This is where the script and admin interface itself will reside, as well as your icons.
Step 2: Open up Iconish's config.php and edit your information as necessary. Go to the bottom of the page and find "require('functions.php')" (line 47-ish) and change it to include your *absolute* path (example: /home/user/path/to/functions.php). Save the page and install Iconish as you normally would, create a few categories, and upload some icons.
Step 3: Create a new WP page template (or make a copy of the default one) that includes the WP header, footer, and sidebar. Edit the template name to something helpful ("Icons" or something). Within the "entry" div, paste the entire contents of Iconish's "index.php" page in. Keeping the "the_content()" and "edit_post_link()" functions are optional; the former will allow you to put any additional content/information on your page along with the icons, and the latter will obviously allow you to click a link to edit the post.
Near the top and bottom, find "include('header.php')" and "include('footer.php')" (lines ~8 and ~220) and delete them. Find "require('config.php')" (line ~7) and edit it to include your absolute path (/home/user/path/to/config.php). Save the file and upload it to your theme's directory.
Step 4: Create a new WP page, set the page template to whatever you named your icon template, and save (you need not put any content in the post box, it won't show up unless you kept the "the_content()" function in your template.) Voila! You should now be able to see your icons on your WP page. You will probably want to edit your theme's stylesheet to include the classes and such used by Iconish (and edit to suit your tastes).
By default it will show your categories on the main page. If you want to put them in the sidebar, open your page template, find the following lines at the bottom:
// showing your icons' categories
echo "<h2>Icon Categories</h2>\n";
iconCatList('index',0,"no");
and delete them. Save the template and upload it to your theme's directory.
PUTTING YOUR CATEGORY LIST IN A SIDEBAR
Although I did this using a separate sidebar page (one that isn't called by the get_sidebar() function) because that particular part of the sidebar changes depending on what is being viewed (icons, textures, whatever), you'll probably be able to just dump this in the sidebar.php file of your theme if you want your categories listed on every page. If you only want it to show up on the icons page, just replace the get_sidebar() function in your page template with include('sidebarname.php'), where "sidebarname" is obviously whatever you named your sidebar. Again, there's probably an easier way to do this, but I'm not savvy enough to figure it out ;)
Step 1: Open your sidebar page and somewhere within the div (wherever you want your category list to show up) put in the following:
<?php echo "<h2>Icon Categories</h2>\n" ?>
<?php
iconCatList('index','0','no'); ?>
----- 'index' is the page the function will look for to use as the icon page is considered 'index.php'. '0' is the top-level page/no category. 'no' means to not show the child categories in the list. -----
Obviously, you can change the echo statement to say whatever you want, or get rid of it altogether (though this is the heading of your sidebar section).
It will output something like this (using the actual names of the categories):
ICON CATEGORIES
-View All
-Cat1
-Cat2
-Cat3
-Cat4
Save the page and upload it to your theme's directory. You should now have a fully functional category list in your sidebar (and you can now go get rid of the "iconCatList()" function within your theme's icon page template, if you like).
Using that particular snippet, if you click on a category that has subcategories, the category list will be replaced with the parent category's children. If you would like to still access the base category list AND see the children of whatever category is currently selected, put the following in your sidebar page instead of the snippet above:
<?php echo "<h2>Icon Categories</h2>\n" ?>
<?php
iconCatList('index','0','no');
if ($cat > '0') {
iconCatList('index',$cat,'no','yes','yes',"$catName"); } ?>
----- 'index' means the page the function will look for to use as the icon page is 'index.php'. '$cat' means to display the category. 'no' means to not show the child categories in the list. 'yes' means to show the number of icons per category. 'yes' means to show the "view All" link. $catName means that the script will display the category name as the list heading. -----
This snippet basically says "If you're on the main icon page, display these categories. If you're not on the main icon page ("0", or the grandpa of all the categories), then display these subcategories instead".
If you select a subcategory, your sidebar will now output something like this:
ICON CATEGORIES
-View All
-Cat1
-Cat2
-Cat3
-Cat4
CATEGORY NAME
-View All
-SubCat1
-SubCat2
-Subcat3
If no subcategory is selected, it will only show the main categories.
Annnd there you go! I hope this helps someone besides me :)
