Sponsored by Topanga @link tenderfeelings.be

As the title says, you have Topanga to thank for this plugin because she paid us to code it, with the explicit condition that it could be freely released to the community once it was finished^(a), because thats kinda what OSS is about huh? As a part of that condition the AstonishMe Team has decided that we won't fully release^(b) this plugin on BOPIT until after the value of it has been made in donations to Topanga. Now, before you all start shaking fingers at us and prodding us with sticks, I should tell you that Topanga will be donating all of the donations she gets for this plugin to Kiva.org and, because we didn't really want paying for this in the first place, we'll be donating the fee to Kiva ourselves .... who said life was simple?

On with the Plugin

This plugin allows you to add custom fields to your posts, so if you're the sort that likes to add "mood", "listening to" and all the other stuff then this is the plugin for you! Once you've installed the plugin you'll be able to add fields to any/all of your blog posts by clicking the nifty little "add new field" button somewhere under your post field ... exactly where kinda depends on if you're in simple or expert mode ... but it'll be there

To make life a little bit simpler each user can have a set of default fields that are added to every post, the fields are only shown if they're filled in so it doesn't really matter how many defaults you have. To make things slightly easier for blog admins they can use the plugin settings to specify the default user settings.

Displaying the fields

Because of the complexity of what Topanga wanted, and seeing as she was paying we had to listen to her, we decided to make the displaying of the fields a widget. This allowed us to add in filters and custom html and other wild and wacky stuff that makes a sunday a brighter place, but because we knew that you lot would bitch if we forced you to add a container to all your skins, we added a shiny new plugin setting for choosing whether to automatically add the fields to the start or the end of your post content .... so new in fact that it's not in the screenshot ... so if you want the easy life just pick top or bottom and press save ... be aware though, if you choose automatic mode then it won't do anything as a widget

Widget mode

As mentioned, this plugin can also be used as a widget that can be thrown into any container you like. If you slap it in one that's inside the post loop then it'll strut it's stuff for each post, but if you slap it outside then it'll attempt to use a single posts stuff ... so it can survive happily enough in the sidebar of your page.main.php / single.main.php If you look at all the widget settings then they'll hopefully make sense to you ... if not then feel free to donate and then demand further instructions .... the chances are you'll pretty much just want to slap it in your container of choice and leave the settings at default

Download the plugin

You can get the latest version of the plugin here ( AM Custom Fields ). Whilst you wait for it to download we'd like you to consider hitting the donation button on the left and donating what you can towards our Kiva fund. This fund will be used to sponsor projects on Kiva. You can visit our Kiva Lender page at any time to see the current status of our ongoing projects.

^(a) Is this explicit enough?

topanga: if you work for me, then I'll pay you
topanga: if you give it away
topanga: then that is other things
yabba_hh: what if I work for you and then I give it away?
topanga: then at least, it will be something that is written especially for my needs
topanga: and if others want it that way
topanga: here they go
yabba_hh: you have no problem with that?
topanga: no I don't
yabba_hh: excellent, cos otherwise I'd do it for you for free
topanga: they can still paypall me 1 euro if they want
topanga: and I give those euro's to kiva.org
topanga: deal closed

^(b) BOPIT will inform you of any updates to the plugin but you will need to come back to this post to download them .... which gives us another opportunity to coerce you into donating to a good cause

• MoodHappy
• ReadingThe screen
• Listening toWater ... seriously