Installation Instructions

1. Uncompress the ZIP file downloaded from this site.
2. Upload the files contained inside it to a folder named "wordpress-filter" inside of your wp-content/plugins directory.
3. Visit Plugins -> Installed within your WordPress administration area
4. Activate WordPress Filter
5. Visit Settings -> WordPress Filter within your WordPress administration area
6. Choose the second tab, Add Filter
7. Set up your Catches and Actions
8. Use the + Add Filter, and + Add Action links to produce more complex Catches and Actions

FAQ

Q: For the actions "Tag(s): Add" and "Tag(s): Remove", what is the correct format for the Action data?

A: Simply a comma-separated list just as you would do on the add/edit Post screen. (ex: "2008, photo")

Q: Will filters be run on a post more then once?

A: A post can have multiple filters run on it, but a specific filter cannot run on a specific post more then once. Depending on community feedback, the ability to let a filter run on a post more then once might be added to a future release.

Q: How is the "Custom Field: Exists" Catch used?

A: To use this, on any post that you want WordPress Filter to potentially engage on, just define the custom field with whatever name you setup as the Catch, then give it any value (the value "1" works perfectly well).

Changelog

v1.3.6

Changes:

• Added Catch -> Post Title: Contains
• Added Action -> Title: Replace Substring
• Added Action -> Content: Replace Substring
• Added Action -> Excerpt: Replace Substring

A special formatting of Action Data is needed to use Substring Replacements. Let's say you wanted to replace all instances of "test" with "testing" inside the content area. To do this:

• Select Content: Replace Substring as the action
• In Action Data enter: test=testing

The basic idea is you supply what you wish to have changed, then "=", followed by what you want to change it to. I'd like to make it a little more user friendly eventually, but I needed this change for something I'm working on and thought I'd share it with you all as well in case it would be helpful.

v1.3.3

Enhancements:

• Fixed a couple of PHP notices that were occurring when the plugin was initially installed.

v1.3 Release Notes

Misc:

• Added ability to import/export filtersets. Filters are validated during import process.
• Much backend work was done to validate adding filters and editing filters. This should provide for a smoother experience in the UI.

v1.2 Release Notes

Misc:

• Improved UI (Tab interaction, text indicators, etc)
• Added confirmation for deleting filter from Current Filters view
• Added form validation
• Decreased database calls and improved sequence of actions being applied

Catches Added:

• Post Excerpt: Equals
• Post Excerpt: Contains
• Post Excerpt: Doesn't Contain

Actions Added:

• Excerpt: Prepend
• Excerpt: Replace
• Excerpt: Append
• Category(ies): Add -> Data supplied for this action should be a comma separated list of Categories by Category Name
• Category(ies): Remove -> Data supplied for this action should be a comma separated list of Categories by Category Name

Bug Fix:

• Fixed small bug with removing Catches or Actions from edit Filter form

v1.1 Release Notes -- Recommended upgrade due to small bug (see below)

Catches Added:

• Post Author: Equals -> The value supplied for this catch should be the Display Name from the users profile
• Comment Status: Equals -> Valid values: open, closed
• Ping Status: Equals -> Valid values: open closed

Actions Added:

• Comment Status: Equals -> Valid values: open, closed
• Ping Status: Equals -> Valid values: open, closed

Bug Fix:

• I ended up moving actions on Categories to v1.2 to go ahead and get this release out there. There is a small bug in v1.0 that will allow a filter to be applied to a post more then once. This bug has been fixed.