外掛說明
This plugin uses custom fields to allow the page title tag to be customised and differ from the actual page title.
Both meta descriptions and keywords can also be added if required.
Page meta details can be modified on any publicly accessible post type, such as posts and pages, as well as custom post types.
Theme and plugin developers should note that it is possible override the page title within your templates by setting $wppm_title = 'Newly defined title';
before the call to get_header();
.
螢幕擷圖
安裝方式
Here we go:
- Upload the
pagemeta
folder to the/wp-content/plugins/
directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Choose which post types the plugin should be enabled on via the
Settings > Reading
options.
常見問題集
- What custom field names does it use?
-
The field names used are
_pagemeta_title
,_pagemeta_description
and_pagemeta_keywords
.The underscore prefix prevents it from being displayed in the list of custom fields.
- How do I output the custom title?
-
If a custom title is set for a post type, the plugin will automatically hook into the
wp_title
function to modify the output.This uses the parameters passed via wp_title and will completely override the title.
You can customise the output further using the
pagemeta_title
filter, which uses the same parameters plus the original post title value.In this example we prefix the original title to the custom title.
add_filter( 'pagemeta_title', function( $title, $sep, $seplocation, $original_title ) { return $original_title . $title; }, 10, 4 );
Please refer to the Codex for further information on the add_filter.
- Why are the meta tags not added to my pages?
-
This plugin makes use of the
wp_head
hook action, therefore in order for it to work there must be a call to wp_head in the current theme header file.More information on this can be found in the WordPress Codex.
- Can I modify which fields are shown?
-
Yes, as of version 1.5 you can modify which fields are used using the
pagemeta_fields
filter:add_filter( 'pagemeta_fields', function( $fields ) { $fields['author'] = 'Author'; // Add a new field. unset( $fields['keywords'] ); // Remove a default field. return $fields; } );
The default fields are ‘title’, ‘description’ and ‘keywords’.
- Can I output the meta values?
-
The page meta values can be output within posts using the
[postmeta]
shortcode.Passing through a
name
attribute will determine which value is returned, for example to output the description value use the following.[postmeta name="description"]
Name values are determined by the fields set, by default these are ‘title’, ‘description’ and ‘keywords’.
To output meta values in template files, you can make use of
the_pagemeta
function.<?php if ( function_exists( 'the_pagemeta' ) ) { the_pagemeta( 'description' ); } ?>
This will output the value, in order to return the value or lookup a specific post ID you can use
get_the_pagemeta
.<?php if ( function_exists( 'get_the_pagemeta' ) ) { $description = get_the_pagemeta( 'description' ); } ?> <?php if ( function_exists( 'get_the_pagemeta' ) ) { $description = get_the_pagemeta( 'description', // Page meta value name 123 // Post ID to lookup ); } ?>
Not that these functions will return the raw values prior to any output manipulation.
使用者評論
參與者及開發者
變更記錄
1.5
- Fix for code previously committed in error, preventing edit page functionality.
1.5
- Added ability to filter / modify meta boxes using the
pagemeta_fields
filter. - Custom titles can now be filtered using
pagemeta_title
. - Meta values are now output for static pages (Front and Posts) assigned via the Reading Settings page.
- For new plugin installs, the plugin will be enabled on pages as well as posts by default.
- Introduced shortcode to allow values to be output in post content.
- New
the_pagemeta
andget_the_pagemeta
functions added. - Addition of basic inline documentation.
1.4.1
- Replaced PHP short tag used to display nonce field on admin edit screen panel.
1.4
- Changed plugin author and contributor names.
- Replaced deactivation hook and tidy option with uninstall.php.
- Modified activation hook to remove warnings during plugin activation.
- Combined settings with Settings > Reading page.
- Allowed meta data to be added to any public post type, instead of just posts and pages.
- Removed PHP shortcodes from edit page meta box.
- Updated donate link.
- Updated screenshots.
1.3
- Page title is now automatically inserted, instead of using the custom function.
1.2
- Fixed issue with WordPress 3.0+ not correctly outputting headers.
1.1
- Fixed errors when error reporting is set to all.
- Tested the plugin in WordPress 2.9.
1.0
- Converted plugin to a class based structure.
- Converted constants into settings page.
- Added donate link 😉
0.3.1
- Bug fix nonce checking and addition of title override.
0.3
- Added ability to allow page meta data on posts, as well as properly escaping values.
0.2.1
- Removed debugging output.
0.2
- Tested up to 2.8.5 and began optimisation of the included files.
0.1
- This is the very first version.