Google\+<\/a>/', ' ', $content );
}
/*
* Prefix caption text.
*/
if ( false !== strpos( $content, '' ) ) {
$caption_prefix = $this->p->opt->get_text( 'plugin_p_cap_prefix' );
if ( ! empty( $caption_prefix ) ) {
$content = preg_replace( '/
/', '$0' . $caption_prefix . ' ', $content );
}
}
/*
* Apply the filter.
*/
$content = apply_filters( 'wpsso_the_content', $content, $mod );
if ( ! is_string( $content ) ) {
if ( $this->p->debug->enabled ) {
$this->p->debug->log( 'content from "wpsso_the_content" is ' . gettype( $content ) );
}
$content = '';
}
/*
* Save content to non-persistant cache.
*/
if ( $cache_exp_secs > 0 ) {
/*
* Adds a group or set of groups to the list of non-persistent groups.
*
* Note that only a few caching plugins support this feature.
*/
wp_cache_add_non_persistent_groups( array( __METHOD__ ) );
wp_cache_set( $cache_id, $cache_array, __METHOD__, $cache_exp_secs );
if ( $this->p->debug->enabled ) {
$this->p->debug->log( 'content array saved to wp_cache for ' . $cache_exp_secs . ' seconds');
}
}
/*
* Maybe put everything on one line but do not cache the re-formatted content.
*/
return $flatten ? preg_replace( '/[\s\r\n]+/s', ' ', $content ) : $content;
}
/*
* Returns the content text, stripped of all HTML tags.
*/
public function get_the_text( array $mod ) {
if ( $this->p->debug->enabled ) {
$this->p->debug->mark();
}
$text = $this->get_the_content( $mod );
$text = preg_replace( '//Us', '', $text );
$text = preg_replace( '/]*>.*<\/pre>/Us', '', $text );
$text = $this->p->util->cleanup_html_tags( $text, $strip_tags = true, $use_img_alt = true );
return apply_filters( 'wpsso_the_text', $text, $mod );
}
/*
* Returns a comma delimited text string of keywords (ie. post tag names).
*/
public function get_keywords_csv( array $mod, $md_key = null ) {
if ( $this->p->debug->enabled ) {
$this->p->debug->mark();
}
$keywords = '';
$is_custom = false;
/*
* Check for custom keywords if a metadata index key is provided.
*/
if ( ! empty( $md_key ) && 'none' !== $md_key ) { // $md_key can be a string or array.
if ( ! empty( $mod[ 'obj' ] ) && $mod[ 'id' ] ) { // Just in case.
$keywords = $mod[ 'obj' ]->get_options_multi( $mod[ 'id' ], $md_key );
if ( ! empty( $keywords ) ) {
$is_custom = false;
if ( $this->p->debug->enabled ) {
$this->p->debug->log( 'custom keywords = ' . $keywords );
}
}
}
}
/*
* If there's no custom keywords, then go ahead and generate the keywords value.
*/
if ( empty( $keywords ) ) {
$tags = $this->get_tag_names( $mod );
if ( ! empty( $tags ) ) {
$keywords = SucomUtil::array_to_keywords( $tags ); // Returns a comma delimited text string.
if ( $this->p->debug->enabled ) {
$this->p->debug->log( 'keywords = ' . $keywords );
}
}
}
return apply_filters( 'wpsso_keywords', $keywords, $mod, $md_key );
}
/*
* Returns a space delimited text string of hashtags.
*/
public function get_hashtags( array $mod, $num_hashtags = false ) {
if ( $this->p->debug->enabled ) {
$this->p->debug->mark();
}
$hashtags = apply_filters( 'wpsso_hashtags_seed', '', $mod, $num_hashtags );
if ( ! empty( $hashtags ) ) { // Seed hashtags returned.
if ( $this->p->debug->enabled ) {
$this->p->debug->log( 'hashtags seed = ' . $hashtags );
}
} elseif ( false !== $num_hashtags ) {
if ( true === $num_hashtags ) {
$num_hashtags = $this->p->options[ 'og_desc_hashtags' ];
}
if ( is_numeric( $num_hashtags ) && $num_hashtags >= 1 ) {
$tags = $this->get_tag_names( $mod );
$tags = array_slice( $tags, 0, $num_hashtags );
if ( ! empty( $tags ) ) {
$hashtags = SucomUtil::array_to_hashtags( $tags );
if ( $this->p->debug->enabled ) {
$this->p->debug->log( 'hashtags = ' . $hashtags );
}
}
}
}
return apply_filters( 'wpsso_hashtags', $hashtags, $mod, $num_hashtags );
}
/*
* Returns an array of post tags.
*/
public function get_tag_names( array $mod ) {
if ( $this->p->debug->enabled ) {
$this->p->debug->mark();
}
/*
* See WpssoIntegEcomWooCommerce->filter_tag_names_seed().
*/
$tags = apply_filters( 'wpsso_tag_names_seed', null, $mod );
if ( ! is_array( $tags ) ) {
if ( $mod[ 'is_post' ] ) {
if ( 'post' === $mod[ 'post_type' ] ) {
$taxonomy = 'post_tag';
} elseif ( 'page' === $mod[ 'post_type' ] && ! empty( $this->p->options[ 'plugin_page_tags' ] ) ) {
$taxonomy = SucomUtil::get_const( 'WPSSO_PAGE_TAG_TAXONOMY' );
} else $taxonomy = '';
if ( ! empty( $mod[ 'post_type' ] ) && is_string( $mod[ 'post_type' ] ) ) { // Not empty string.
$filter_name = SucomUtil::sanitize_hookname( 'wpsso_' . $mod[ 'post_type' ] . '_tag_taxonomy' );
$taxonomy = apply_filters( $filter_name, $taxonomy, $mod );
if ( ! empty( $taxonomy ) ) {
$tags = wp_get_post_terms( $mod[ 'id' ], $taxonomy, $args = array( 'fields' => 'names' ) );
}
unset( $filter_name, $taxonomy );
}
}
}
$tags = is_array( $tags ) ? array_unique( $tags ) : array();
$tags = apply_filters( 'wpsso_tag_names', $tags, $mod );
if ( $this->p->debug->enabled ) {
$this->p->debug->log_arr( 'tags', $tags );
}
return $tags;
}
/*
* Includes parent names in the term title by default, unless the $title_sep value is false.
*
* See WpssoUtilInline->replace_callback().
* See WpssoFaqShortcodeFaq->do_shortcode().
*/
public function get_term_title( $term_id = 0, $title_sep = null ) {
if ( $this->p->debug->enabled ) {
$this->p->debug->mark();
}
$term_obj = SucomUtilWP::get_term_object( $term_id );
$term_id = isset( $term_obj->term_id ) ? $term_obj->term_id : 0;
$title_text = isset( $term_obj->name ) ? $term_obj->name : '';
$title_sep = $this->maybe_get_title_sep( $title_sep ); // Returns default title separator (decoded) if not provided.
/*
* If we have a title separator and a parent, then redefine the title text with the parent list.
*/
if ( ! empty( $title_sep ) ) {
if ( ! empty( $term_obj->parent ) ) {
$term_parents = get_term_parents_list( $term_id, $term_obj->taxonomy, $args = array(
'format' => 'name', // Use term names or slugs for display.
'separator' => ' ' . $title_sep . ' ', // Separator for between the terms.
'link' => false, // Whether to format as a link.
'inclusive' => true, // Include the term to get the parents for.
) );
if ( $term_parents && ! is_wp_error( $term_parents ) ) {
/*
* Trim excess separator.
*/
$title_text = preg_replace( '/ *' . preg_quote( $title_sep, '/' ) . ' *$/', '', $term_parents );
}
}
}
return apply_filters( 'wpsso_term_title', $title_text, $term_id, $title_sep );
}
/*
* Returns an empty or formatted string (number with minutes).
*/
public function get_reading_time( array $mod ) {
$reading_mins = $this->get_reading_mins( $mod );
return $this->fmt_reading_mins( $reading_mins );
}
public function get_reading_mins( array $mod ) {
$content = $this->get_the_content( $mod );
$words_per_min = WPSSO_READING_WORDS_PER_MIN;
$reading_mins = null;
if ( $mod[ 'obj' ] && $mod[ 'id' ] ) { // Just in case.
$reading_mins = $mod[ 'obj' ]->get_options( $mod[ 'id' ], 'schema_reading_mins' );
}
if ( null === $reading_mins ) { // Default value or no custom value.
$reading_mins = round( str_word_count( wp_strip_all_tags( $content ) ) / $words_per_min );
}
return $reading_mins;
}
public function fmt_reading_mins( $reading_mins ) {
return $reading_mins ? sprintf( _n( '%s minute', '%s minutes', $reading_mins, 'wpsso' ), $reading_mins ) : '';
}
/*
* Add a separator and a value to the left/right hand side of the title.
*/
private function add_title_part( &$title, $title_sep, $part, $hand = 'right' ) {
if ( $part ) { // Adding an empty $part would leave a hanging separator.
if ( $title ) {
if ( 'left' === $hand ) {
$title = $part . ' ' . trim( $title_sep . ' ' . $title );
} else $title = trim( $title . ' ' . $title_sep ) . ' ' . $part;
} else $title = $part; // We have a part, but no title.
}
return trim( $title );
}
/*
* Public method to sanitize arguments or modify values for get_title(), get_description(), etc.
*
* Returns default ellipsis (decoded) if not provided (ie. $ellipsis = null).
*/
private function maybe_get_ellipsis( $ellipsis = null ) {
if ( null === $ellipsis ) {
$ellipsis = html_entity_decode( $this->p->options[ 'og_ellipsis' ], ENT_QUOTES, $this->charset );
}
return $ellipsis;
}
/*
* Public method to sanitize arguments or modify values for get_title(), get_description(), etc.
*
* Returns default title separator (decoded) if not provided (ie. $title_sep = null).
*/
private function maybe_get_title_sep( $title_sep = null ) {
if ( null === $title_sep ) {
$title_sep = html_entity_decode( $this->p->options[ 'og_title_sep' ], ENT_QUOTES, $this->charset );
}
return $title_sep;
}
/*
* Public method to sanitize arguments or modify values for get_title(), get_description(), etc.
*/
private function maybe_get_opt_multi( $mod, $md_key ) {
if ( ! empty( $md_key ) && 'none' !== $md_key ) { // Make sure we have something to work with.
if ( ! empty( $mod[ 'obj' ] ) && $mod[ 'id' ] ) { // Just in case.
return $mod[ 'obj' ]->get_options_multi( $mod[ 'id' ], $md_key );
}
}
return null;
}
/*
* Private method to sanitize arguments or modify values for get_title(), get_description(), etc.
*
* Returns an array of metadata keys (can be empty).
*
* $md_key = true | false | string | array
*/
private function sanitize_md_key( $md_key, $def_key = '' ) {
if ( false === $md_key || 'none' === $md_key || '' === $md_key ) { // Nothing to do.
return array();
} elseif ( true === $md_key || null === $md_key || $md_key === $def_key ) { // Return the default key array.
return WpssoConfig::get_md_keys_fallback( $def_key );
}
if ( ! is_array( $md_key ) ) {
$md_key = WpssoConfig::get_md_keys_fallback( $md_key );
}
foreach ( WpssoConfig::get_md_keys_fallback( $def_key ) as $key ) {
$md_key[] = $key;
}
$md_key = array_unique( $md_key ); // Just in case.
return $md_key;
}
/*
* Private method to sanitize arguments or modify values for get_title(), get_description(), etc.
*
* Return 0 by default.
*/
private function sanitize_max_len( $max_len ) {
if ( is_numeric( $max_len ) ) {
return (int) $max_len;
} elseif ( is_array( $max_len ) && isset( $max_len[ 'max' ] ) ) {
return (int) $max_len[ 'max' ];
} elseif ( is_string( $max_len ) ) {
$input_limits = WpssoConfig::get_input_limits( $max_len ); // Uses a local cache.
if ( ! empty( $input_limits[ 'max' ] ) ) {
return (int) $input_limits[ 'max' ];
}
}
return 0;
}
}
}