/home/techb158/balacoffee.com/wp-content/plugins/polylang/src
Edit: /home/techb158/balacoffee.com/wp-content/plugins/polylang/src/term-slug.php (5012B)
model = $model;
$this->slug = $slug;
$this->taxonomy = $taxonomy;
$this->name = $name;
$this->term_id = $term_id;
}
/**
* Tells if the suffix can be added or not.
*
* @since 3.7
*
* @return bool True if the suffix can be added, false otherwise.
*/
private function can_add_suffix() {
/**
* Filters the subsequently inserted term language.
*
* @since 3.3
*
* @param PLL_Language|null $lang Found language object, null otherwise.
* @param string $taxonomy Term taxonomy.
* @param string $slug Term slug.
*/
$lang = apply_filters( 'pll_inserted_term_language', null, $this->taxonomy, $this->slug );
if ( ! $lang instanceof PLL_Language ) {
return false;
}
$this->lang = $lang;
$this->parent = 0;
if ( is_taxonomy_hierarchical( $this->taxonomy ) ) {
/**
* Filters the subsequently inserted term parent.
*
* @since 3.3
*
* @param int $parent Parent term ID, 0 if none.
* @param string $taxonomy Term taxonomy.
* @param string $slug Term slug.
*/
$this->parent = apply_filters( 'pll_inserted_term_parent', 0, $this->taxonomy, $this->slug );
$this->slug .= $this->maybe_get_parent_suffix();
}
if ( ! $this->slug ) {
if ( $this->model->term_exists( $this->name, $this->taxonomy, $this->parent, $this->lang ) ) {
// Returns the current empty slug if the term exists with the same name and an empty slug.
// Same as WP does when providing a term with a name that already exists and no slug.
return false;
} else {
$this->slug = sanitize_title( $this->name );
}
}
// Check if the slug exists globally, excluding the current term if we're editing.
$args = array(
'slug' => $this->slug,
'taxonomy' => $this->taxonomy,
'hide_empty' => false,
'fields' => 'ids',
'lang' => '', // Disable Polylang language filter.
'update_term_meta_cache' => false, // Don't need term meta.
);
$terms = get_terms( $args );
// Return true if the slug is already used by another term (excluding the term being edited).
return is_array( $terms ) && ! empty( array_diff( $terms, array( $this->term_id ) ) );
}
/**
* Returns the parent suffix for the slug only if parent slug is the same as the given one.
* Recursively appends the parents slugs like WordPress does.
*
* @since 3.3
* @since 3.7 Moved from `PLL_Share_Term_Slug` to `PLL_Term_Slug`.
*
* @return string Parents slugs if they are the same as the child slug, empty string otherwise.
*/
private function maybe_get_parent_suffix() {
$parent_suffix = '';
$the_parent = get_term( $this->parent, $this->taxonomy );
if ( ! $the_parent instanceof WP_Term || $the_parent->slug !== $this->slug ) {
return $parent_suffix;
}
/**
* Mostly copied from {@see wp_unique_term_slug()}.
*/
while ( ! empty( $the_parent ) ) {
$parent_term = get_term( $the_parent, $this->taxonomy );
if ( ! $parent_term instanceof WP_Term ) {
break;
}
$parent_suffix .= '-' . $parent_term->slug;
if ( ! term_exists( $this->slug . $parent_suffix ) ) {
break;
}
$the_parent = $parent_term->parent;
}
return $parent_suffix;
}
/**
* Returns the term slug, suffixed or not.
*
* @since 3.7
*
* @param string $separator The separator for the slug suffix.
* @return string The slug with or without suffix.
*/
public function get_suffixed_slug( string $separator ): string {
if ( ! $this->can_add_suffix() ) {
return $this->slug;
}
$term_id = (int) $this->model->term_exists_by_slug( $this->slug, $this->lang, $this->taxonomy, $this->parent );
// If no term exists in the given language with that slug, it can be created, or if we are editing the existing term.
if ( ! $term_id || $this->term_id === $term_id ) {
return $this->slug . $separator . $this->lang->slug;
}
// Different term exists in same language: no suffix, WordPress will handle uniqueness.
return $this->slug;
}
}