We spent hours trying to find a solution for adding permalink settings to our popular BePro Listings plugin. The wordpress documentation, does not mention the permalink page or show any examples
- http://codex.wordpress.org/Settings_API
We have also seen a years long thread from the development team with what seems to be an attempt to fix the issues related to the permalink page
- https://core.trac.wordpress.org/ticket/9296
This post is short and to the point. We will demonstrate exactly how you can add your custom permalink input fields onto the settings page. We will also demonstrate how you can save this information. The use of the settings in the url of pages is not covered in this article
THE APPROACH
This first code example is focused on placing your details under the options sections on the permalink page. This is the simplest approach.
add_action('admin_init', 'permalink_admin_init' );
function permalink_admin_init(){
add_settings_field(
'some_identifier', //id for your field
'title', //title for the field
'permalink_setting_input', //callback function you will use to show the field (html)
'permalink', //permalink page
'optional' //optional section
);
}
function permalink_setting_input() {
$options = get_option( 'your_option_name' );
$value = $options['permalink'];
// echo the field
?>
<code><!--?php bloginfo("url"); ?--></code><input id="permalink_option" type="text" name="permalink_option" /> type='text' value='<!--?php echo esc_attr( $value ); ?-->' /> e.g. /listings
<!--?php <br ?--> }
That’s the beginning of it. At this point, your field should be visible on the permalink page in the options section. The next part is to catch the save event and process the submitted value yourself.
function permalink_save_options( ) {
if(isset($_POST["permalink_option"])){
$options = get_option( 'your_option_name' );
$options["permalink"] = $_POST["permalink_option"]; // do some security checks here if you want
update_option("your_option_name", $options);
}
}
This last section completes the process. At this point, your input fields will be on the permalink settings page in the options section and you will be able to save the value.
CONCLUSION
When delving into the deepest parts of wordpress, it can often be difficult to find answers. Our team of wordpress experts recently ran into this issue of trying to create permalink settings on the admin page. With the examples above, you can get started on the process too!
In part 2 of this article, we will cover the creation of your own permalink section compared to using pre-exiting sections.
