PHP Класс The_SEO_Framework\Generate_Title

Generates title SEO data based on content.
С версии: 2.7.1
Наследование: extends Generate_Description
Показать файл Открыть проект

Открытые методы

Метод Описание
add_title_additions ( ) : boolean Determines whether to add or remove title additions.
add_title_pagination ( string $title ) : string Adds title pagination, if paginated.
add_title_protection ( $title, $id ) : string Adds title protection prefixes.
build_title ( string $title = '', string $seplocation = '', array $args = [] ) : string Builds the title based on input and query status.
build_title_doingitwrong ( string $title = '', string $sep = '', string $seplocation = '', array $args = [] ) : string Builds the title based on input and query status for themes that are doing it wrong.
do_title_pre_filter ( string $title, array $args, boolean $escape = true ) : string Filters the title prior to output.
do_title_pro_filter ( string $title, array $args, boolean $escape = true ) : string Filters the title prior to output.
escape_title ( string $title = '', boolean $trim = true ) : string Escapes and beautifies title.
generate_home_title ( boolean $get_custom_field = true, string $seplocation = '', string $deprecated = '', boolean $escape = true, boolean $get_option = true ) : array Generate the title based on conditions for the home page.
generate_title ( array $args = [], boolean $escape = true ) : string Generate the title based on query conditions.
get_custom_field_title ( string $title = '', integer $id = '', string $taxonomy = '' ) : string Returns custom field title.
get_home_title_seplocation ( string $seplocation = '' ) : string Gets Title Seplocation for the homepage.
get_the_404_title ( string $title = '' ) : string Returns 404 title.
get_the_real_archive_title ( object $term = null, array $args = [] ) : string Gets the archive Title, including filter. Also works in admin.
get_the_search_title ( string $title = '', boolean $escape = true ) : string Returns search title.
get_title_separator ( ) : string Gets Title Separator.
get_title_seplocation ( string $seplocation = '', boolean $home = false ) : string Gets Title Seplocation.
home_page_add_title_tagline ( ) : boolean Determines whether to add home page tagline.
parse_title_args ( array $args = [], array $defaults = [], boolean $get_defaults = false ) : array Parse and sanitize title args.
post_title_from_ID ( integer $id, string $title = '' ) : string Returns Post Title from ID.
process_title_additions ( string $title = '', string $blogname = '', string $seplocation = '' ) : string Adds the title additions to the title.
reparse_title_args ( array $args = [] ) : array Reparses title args.
single_term_title ( $prefix = '', $display = true, $term = null ) : string Fetches single term title.
title ( string $title = '', string $sep = '', string $seplocation = '', array $args = [] ) : string Gets the title. Main function.
title_for_home ( string $home_title = '', boolean $get_custom_field = true, boolean $escape = false, boolean $get_option = true ) : string Gets the title for the static home page.
title_for_terms ( array $args = [], boolean $escape = false ) : string Gets the title for Category, Tag or Taxonomy
title_from_custom_field ( string $title = '', boolean $escape = false, integer $id = null, string $taxonomy = null ) : string Gets the title from custom field
title_from_special_fields ( ) : string Fetches title from special fields, like other plugins with special queries.
untitled ( ) : string Returns untitled title.
use_archive_prefix ( object $term = null, array $args = [] ) : boolean Determines whether to use a title prefix or not.

Защищенные методы

Метод Описание
__construct ( ) Constructor, load parent constructor
build_title_notagline ( array $args = [] ) : string Builds the title based on input, without tagline.
get_notagline_title ( array $args = [] ) : string Build the title based on input, without tagline.

Описание методов

__construct() защищенный Метод

Constructor, load parent constructor
protected __construct ( )

add_title_additions() публичный Метод

Determines whether to add or remove title additions.
С версии: 2.4.3 Applies filters the_seo_framework_add_blogname_to_title : boolean
С версии: 2.6.0:
public add_title_additions ( ) : boolean
Результат boolean True when additions are allowed.

add_title_pagination() публичный Метод

Adds title pagination, if paginated.
С версии: 2.6.0
public add_title_pagination ( string $title ) : string
$title string The current Title.
Результат string Title with maybe pagination added.

add_title_protection() публичный Метод

Adds title protection prefixes.
С версии: 2.6.0
public add_title_protection ( $title, $id ) : string
$title The current Title.
$id The page ID.
Результат string $title with possible affixes.

build_title() публичный Метод

Builds the title based on input and query status.
С версии: 2.4.0
public build_title ( string $title = '', string $seplocation = '', array $args = [] ) : string
$title string The Title to return
$seplocation string The Title sepeartor location ( accepts 'left' or 'right' )
$args array : accepted args : { @param int term_id The Taxonomy Term ID @param string taxonomy The Taxonomy name @param bool page_on_front Page on front condition for example generation @param bool placeholder Generate placeholder, ignoring options. @param bool get_custom_field Do not fetch custom title when false. @param bool is_front_page Fetch front page title. }
Результат string $title Title

build_title_doingitwrong() публичный Метод

Pretty much a duplicate of build_title but contains different variables. Keep this in mind.
С версии: 2.4.0
public build_title_doingitwrong ( string $title = '', string $sep = '', string $seplocation = '', array $args = [] ) : string
$title string The Title to return
$sep string The Title sepeartor
$seplocation string The Title sepeartor location ( accepts 'left' or 'right' )
$args array : accepted args : { @param int term_id The Taxonomy Term ID @param string taxonomy The Taxonomy name @param bool placeholder Generate placeholder, ignoring options. @param bool get_custom_field Do not fetch custom title when false. }
Результат string $title Title

build_title_notagline() защищенный Метод

Builds the title based on input, without tagline.
С версии: 2.4.0
protected build_title_notagline ( array $args = [] ) : string
$args array : accepted args : { @param int term_id The Taxonomy Term ID @param bool placeholder Generate placeholder, ignoring options. @param bool page_on_front Page on front condition for example generation }
Результат string Title without tagline.

do_title_pre_filter() публичный Метод

Filters the title prior to output.
С версии: 2.6.0
public do_title_pre_filter ( string $title, array $args, boolean $escape = true ) : string
$title string The current title.
$args array The title args.
$escape boolean Whether to escape the title.
Результат string $title

do_title_pro_filter() публичный Метод

Filters the title prior to output.
С версии: 2.6.0
public do_title_pro_filter ( string $title, array $args, boolean $escape = true ) : string
$title string The current title.
$args array The title args.
$escape boolean Whether to escape the title.
Результат string $title

escape_title() публичный Метод

Escapes and beautifies title.
С версии: 2.5.2
public escape_title ( string $title = '', boolean $trim = true ) : string
$title string The title to escape and beautify.
$trim boolean Whether to trim the title from whitespaces.
Результат string Escaped and beautified title.

generate_home_title() публичный Метод

Generate the title based on conditions for the home page.
С версии: 2.3.4
public generate_home_title ( boolean $get_custom_field = true, string $seplocation = '', string $deprecated = '', boolean $escape = true, boolean $get_option = true ) : array
$get_custom_field boolean Fetch Title from Custom Fields.
$seplocation string The separator location
$deprecated string Deprecated: The Home Page separator location
$escape boolean Parse Title through saninitation calls.
$get_option boolean Whether to fetch the SEO Settings option.
Результат array { 'title' => (string) $title : The Generated Title 'blogname' => (string) $blogname : The Generated Blogname 'add_tagline' => (bool) $add_tagline : Whether to add the tagline 'seplocation' => (string) $seplocation : The Separator Location }

generate_title() публичный Метод

Generate the title based on query conditions.
С версии: 2.3.4
public generate_title ( array $args = [], boolean $escape = true ) : string
$args array The Title Args.
$escape boolean Parse Title through saninitation calls.
Результат string $title The Generated Title.

get_custom_field_title() публичный Метод

Returns custom field title.
С версии: 2.6.0
public get_custom_field_title ( string $title = '', integer $id = '', string $taxonomy = '' ) : string
$title string The current title.
$id integer The post or TT ID.
$taxonomy string The TT name.
Результат string $title The custom field title.

get_home_title_seplocation() публичный Метод

Gets Title Seplocation for the homepage.
С версии: 2.6.0
public get_home_title_seplocation ( string $seplocation = '' ) : string
$seplocation string The current seplocation.
Результат string The Seplocation for the homepage.

get_notagline_title() защищенный Метод

Note: Not escaped.
С версии: 2.6.0
protected get_notagline_title ( array $args = [] ) : string
$args array : accepted args : { @param int term_id The Taxonomy Term ID @param bool placeholder Generate placeholder, ignoring options. @param bool page_on_front Page on front condition for example generation }
Результат string Title without tagline.

get_the_404_title() публичный Метод

Returns 404 title.
С версии: 2.6.0
С версии: 2.5.2: Applies filters string the_seo_framework_404_title
public get_the_404_title ( string $title = '' ) : string
$title string The current Title
Результат string 404 Title

get_the_real_archive_title() публичный Метод

Gets the archive Title, including filter. Also works in admin.
С версии: 2.6.0
public get_the_real_archive_title ( object $term = null, array $args = [] ) : string
$term object The Term object.
$args array The Title arguments.
Результат string The Archive Title, not escaped.

get_the_search_title() публичный Метод

Returns search title.
С версии: 2.6.0
public get_the_search_title ( string $title = '', boolean $escape = true ) : string
$title string the current title.
$escape boolean Whether to escape attributes from query.
Результат string Search Title

get_title_separator() публичный Метод

Gets Title Separator.
С версии: 2.6.0
С версии: 2.3.9: Applies filters the_seo_framework_title_separator
public get_title_separator ( ) : string
Результат string The Separator, unescaped.

get_title_seplocation() публичный Метод

Gets Title Seplocation.
С версии: 2.3.9 Applies filters the_seo_framework_title_seplocation : string the title location. Applies filters the_seo_framework_title_seplocation_front : string the home page title location.
С версии: 2.6.0:
public get_title_seplocation ( string $seplocation = '', boolean $home = false ) : string
$seplocation string The current seplocation.
$home boolean The home seplocation.
Результат string The Seplocation

home_page_add_title_tagline() публичный Метод

Determines whether to add home page tagline.
С версии: 2.6.0
public home_page_add_title_tagline ( ) : boolean
Результат boolean

parse_title_args() публичный Метод

Parse and sanitize title args.
С версии: 2.4.0
public parse_title_args ( array $args = [], array $defaults = [], boolean $get_defaults = false ) : array
$args array required The passed arguments.
$defaults array The default arguments.
$get_defaults boolean Return the default arguments. Ignoring $args.
Результат array $args parsed args.

post_title_from_ID() публичный Метод

Returns Post Title from ID.
С версии: 2.6.0
public post_title_from_ID ( integer $id, string $title = '' ) : string
$id integer The Post ID.
$title string Optional. The current/fallback Title.
Результат string Post Title

process_title_additions() публичный Метод

Adds the title additions to the title.
С версии: 2.6.0
public process_title_additions ( string $title = '', string $blogname = '', string $seplocation = '' ) : string
$title string The tite.
$blogname string The blogname.
$seplocation string The separator location.
Результат string Title with possible additions.

reparse_title_args() публичный Метод

Reparses title args.
С версии: 2.6.0
public reparse_title_args ( array $args = [] ) : array
$args array required The passed arguments.
Результат array $args parsed args.

single_term_title() публичный Метод

Fetches single term title.
С версии: 2.6.0
public single_term_title ( $prefix = '', $display = true, $term = null ) : string
Результат string Single term title.

title() публичный Метод

Always use this function for the title unless you're absolutely sure what you're doing. This function is used for all these: Taxonomies and Terms, Posts, Pages, Blog, front page, front-end, back-end.
С версии: 1.0.0 Params required wp_title filter :
С версии: 2.4.0:
public title ( string $title = '', string $sep = '', string $seplocation = '', array $args = [] ) : string
$title string The Title to return
$sep string The Title sepeartor
$seplocation string The Title sepeartor location ( accepts 'left' or 'right' )
$args array : accepted args : { @param int term_id The Taxonomy Term ID when taxonomy is also filled in. Else post ID. @param string taxonomy The Taxonomy name. @param bool page_on_front Page on front condition for example generation. @param bool placeholder Generate placeholder, ignoring options. @param bool notagline Generate title without tagline. @param bool meta Ignore doing_it_wrong. Used in og:title/twitter:title @param bool get_custom_field Do not fetch custom title when false. @param bool description_title Fetch title for description. @param bool is_front_page Fetch front page title. }
Результат string $title Title

title_for_home() публичный Метод

Essentially falling back to the blogname. Not to be confused with $blogname.
С версии: 2.2.8
public title_for_home ( string $home_title = '', boolean $get_custom_field = true, boolean $escape = false, boolean $get_option = true ) : string
$home_title string The fallback title.
$get_custom_field boolean Fetch Title from InPost Custom Fields.
$escape boolean Parse Title through saninitation calls.
$get_option boolean Whether to fetch the SEO Settings option.
Результат string The Title.

title_for_terms() публичный Метод

Gets the title for Category, Tag or Taxonomy
С версии: 2.2.8
public title_for_terms ( array $args = [], boolean $escape = false ) : string
$args array The Title arguments.
$escape boolean Parse Title through saninitation calls.
Результат string The Title.

title_from_custom_field() публичный Метод

Gets the title from custom field
С версии: 2.2.8
public title_from_custom_field ( string $title = '', boolean $escape = false, integer $id = null, string $taxonomy = null ) : string
$title string the fallback title.
$escape boolean Parse Title through saninitation calls.
$id integer The Post ID.
$taxonomy string The term name.
Результат string The Title.

title_from_special_fields() публичный Метод

Used before and has priority over custom fields. Front end only.
С версии: 2.5.2
public title_from_special_fields ( ) : string
Результат string $title Title from Special Field.

untitled() публичный Метод

Returns untitled title.
С версии: 2.6.0
public untitled ( ) : string
Результат string Untitled. Not escaped.

use_archive_prefix() публичный Метод

Determines whether to use a title prefix or not.
С версии: 2.6.0
public use_archive_prefix ( object $term = null, array $args = [] ) : boolean
$term object The Term object.
$args array The title arguments.
Результат boolean