=== Permalink Editor ===
Contributors: Fubra
Tags: permalink, url, link, post, page, custom, redirect, edit, structure, category, tag
Requires at least: 3.0.1
Tested up to: 3.1
Stable tag: 0.2

Fully customise the permalink for a particular page or post or globally set the permalink structure for pages.

== Description ==

This plugin adds two areas of functionality: Global page permalink structure and individual custom permalinks.

An option is added to the Permalinks Settings page allowing you to specify the structure for pages.

By default - if custom permalinks are enabled - pages are accessible in the format `/page/` or `/parent/page/`.

You can modify this format in many different ways, for example:

* Add an extension: `/%pagename%.html`
* Add a parent directory name: `/content/%pagename%/`
* Prefix the page name: `/page-%pagename%/`
* Or using a combination of the above.

**Note:** Ensure you have included the `%pagename%` structure tag somewhere in the url.

Additionally an option is added to the edit page allow you to specify the permalink for an individual post or page.

To remove a custom permalink, simply remove the value and it will default to the original permalink.

== Installation ==

1. Unzip the package, and upload `page-permalink` to the `/wp-content/plugins/` directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. Go to the permalink settings page *(Settings > Permalinks)* and set your custom global page permalink structure.
1. Individual post permalinks can be edited via the edit post screen.

== Frequently Asked Questions ==

= Why is the customise button now showing? =

If you have not enabled custom permalinks *(Settings > Permalinks)* and they are set to the default option,
the plugin will not recognise that custom permalink structures are enabled.

= What is a permalink alias? =

A permalink alias is an additional permalink value that can be set to redirect to the actual permalink.

If a user enters the URL of an existing alias value, it will header redirect *(301)* them to the correct location.

= How can I remove a custom permalink? =

* Click the `Customise` permalink button on the admin edit screen.
* Empty the input containing the permalink.
* Click on `OK` and update the entry to apply the changes.

The default permalink structure will then be applied.

= Why do numbers keep appearing at the end of my permalink? =

Permalinks should by unique across your site, if you are trying to define a duplicate a numeric value will be appended to the end.

For example, if there is an existing custom slug of "/post.html", it will be turned into "/post.html2".

= What features are there still left to implement? =

* Complete removal of the Category or Tag base. (Currently only achievable in WP 3.1+ and by setting a custom Category permalink, e.g. "/%category%.html")
* Option to remove parent categories from the category permalink. (E.g. "/parent/child/" becomes just "/child/")

= What is the order of priority used for redirects? =

1. Check for a custom permalink if the current request returns a 404 error. *(Defined on the individual edit page)*
1. Use the global permalink structure. *(Defined on the permalink settings page)*
1. Lookup an alias permalink if no existing page is found. *(Defined on the individual edit page)*

== Screenshots ==

1. The customise button is added to the permalink edit area.
1. Customise button allows you to edit the whole permalink.
1. The permalink alias box appears towards the bottom of the edit screen.
1. Define the page permalink structure on Settings > Permalinks options page.

== Upgrade Notice ==

Due to the addition of category and tag permalink customisation, in order to keep the plugin footprint to a minimum
the method of storing settings has changed.

This means that anybody using the global page structure settings in any plugin version < 0.2, will need
to visit the Permalink Settings page and re-enter the page structure.

Apologies for making this incompatible change.

== Changelog ==

= 0.2 =
* Added the ability to customise category and tag permastructs.
* Adjusted addition of filters so they are not applied if custom permalinks are disabled.
* Changed user capability check to 'manage_options'.
* *Updated 2011-02-15.*
= 0.1.9 =
* Fixed error output when trying to access a page using a permalink alias.
* Addition on the version update dates in the change log.
* *Updated 2011-02-14.*
= 0.1.8 =
* Changed the method used for checking file extensions.
* Fixed Edit Permalink button when creating a new post / page.
* Removed formatting of permalinks if rewriting is not enabled / default permalinks used.
* *Updated 2011-02-07.*
= 0.1.7 =
* Modified the method of including the JavaScript file, affected the customise button in versions prior to WP 3.1.
* *Updated 2011-02-05.*
= 0.1.6 =
* Enabled permalinks on drafts to be edited and customised.
* *Updated 2011-02-04.*
= 0.1.5 =
* Removed unexpected output and modified contributers list.
* *Updated 2011-02-04.*
= 0.1.4 =
* Removed debugging info.
* *Updated 2011-02-03.*
= 0.1.3 =
* Trailing slash check now applies to all post types, including custom post types.
* Reordered get_custom_permalink_sample arguments to ensure the permalink is returned by default.
* Modified the way requests are parsed.
* *Updated 2011-02-03.*
= 0.1.2 =
* Removed manual setting of 404 error. (Fixes lookup for non-custom permalinks)
* *Updated 2011-02-01.*
= 0.1.1 =
* Fallback check to get post by custom permalink now passes original lookup parameters. (Fixes failed alias lookup)
* *Updated 2011-02-01.*
= 0.1 =
* This is the very first version.
* *Updated 2011-02-01.*