File: /www/wwwroot/softfox.com.cn/wp-content/plugins/wpjam-basic/includes/class-wpjam-term.php
<?php
class WPJAM_Term{
use WPJAM_Instance_Trait;
protected $id;
protected function __construct($id){
$this->id = (int)$id;
}
public function __get($key){
if(in_array($key, ['id', 'term_id'])){
return $this->id;
}elseif($key == 'tax_object'){
return wpjam_get_taxonomy_object($this->taxonomy);
}elseif($key == 'ancestors'){
return get_ancestors($this->id, $this->taxonomy, 'taxonomy');
}elseif($key == 'children'){
return get_term_children($this->id, $this->taxonomy);
}elseif($key == 'object_type'){
return $this->tax_object ? $this->tax_object->object_type : [];
}elseif($key == 'level'){
return $this->parent ? count($this->ancestors) : 0;
}elseif($key == 'depth'){
if($this->children){
$max = 0;
foreach($this->children as $child){
$level = count(get_ancestors($child, $this->taxonomy, 'taxonomy'));
if($max < $level){
$max = $level;
}
}
return $max - $this->level;
}
return 0;
}elseif($key == 'link'){
return get_term_link($this->term);
}elseif($key == 'term'){
return get_term($this->id);
}else{
$term = $this->term;
if(isset($term->$key)){
return $term->$key;
}else{
return wpjam_get_metadata('term', $this->id, $key, null);
}
}
}
public function __isset($key){
return $this->$key !== null;
}
public function value_callback($field){
if(isset($this->term->$field)){
return $this->term->$field;
}else{
return wpjam_get_metadata('term', $this->id, $field);
}
}
public function update_callback($data, $defaults){
$term_data = array_pulls($data, self::get_field_keys());
$result = $term_data ? $this->save($term_data) : true;
if(!is_wp_error($result) && $data){
$defaults = array_except($defaults, self::get_field_keys());
return $this->meta_input($data, $defaults);
}
return $result;
}
public function supports($feature){
return $this->tax_object ? $this->tax_object->supports($feature) : false;
}
public function save($data){
return self::update($this->id, $data, false);
}
public function is_deletable(){
return true;
}
public function is_object_in($object_id){
return is_object_in_term($object_id, $this->taxonomy, $this->id);
}
public function set_object($object_id, $append=false){
return wp_set_object_terms($object_id, [$this->id], $this->taxonomy, $append);
}
public function add_object($object_id){
return wp_add_object_terms($object_id, [$this->id], $this->taxonomy);
}
public function remove_object($object_id){
return wp_remove_object_terms($object_id, [$this->id], $this->taxonomy);
}
public function get_object_type(){
return $this->object_type;
}
public function get_thumbnail_url($size='full', $crop=1){
$thumbnail = $this->thumbnail ?: apply_filters('wpjam_term_thumbnail_url', '', $this->term);
if($thumbnail){
if(!$size && $this->tax_object){
$size = $this->tax_object->thumbnail_size;
}
$size = $size ?: 'thumbnail';
return wpjam_get_thumbnail($thumbnail, $size, $crop);
}
return '';
}
public function parse_with_children($terms=null, $max_depth=0, $depth=0, $format=''){
$children = [];
if($max_depth == 0 || $max_depth > $depth+1){
if($terms && isset($terms[$this->id])){
foreach($terms[$this->id] as $child){
$object = self::get_instance($child);
$_children = $object->parse_with_children($terms, $max_depth, $depth+1, $format);
$children = array_merge($children, $_children);
}
}
}
$term = $this->parse_for_json();
if($format == 'flat'){
$term['name'] = str_repeat(' ', $depth).$term['name'];
return array_merge([$term], $children);
}else{
return [array_merge($term, ['children'=>$children])];
}
}
public function parse_for_json(){
$json = [];
$json['id'] = $this->id;
$json['taxonomy'] = $this->taxonomy;
$json['name'] = html_entity_decode($this->name);
$json['count'] = (int)$this->count;
$json['description'] = $this->description;
if(is_taxonomy_viewable($this->taxonomy)){
$json['slug'] = $this->slug;
}
if(is_taxonomy_hierarchical($this->taxonomy)){
$json['parent'] = $this->parent;
}
foreach(wpjam_get_term_options($this->taxonomy) as $option){
$json = array_merge($json, $option->prepare($this->id));
}
return apply_filters('wpjam_term_json', $json, $this->id);
}
public function meta_input(...$args){
if($args){
return wpjam_update_metadata('term', $this->id, ...$args);
}
}
public static function get_instance($term, $taxonomy=null, $wp_error=false){
$term = self::validate($term, $taxonomy);
if(is_wp_error($term)){
return $wp_error ? $term : null;
}
$term_id = $term->term_id;
$taxonomy = $term->taxonomy;
$object = wpjam_get_taxonomy_object($taxonomy);
$model = $object ? $object->model : 'WPJAM_Term';
return call_user_func([$model, 'instance'], $term_id);
}
public static function get($term){
$data = $term ? self::get_term($term, '', ARRAY_A) : [];
if($data && !is_wp_error($data)){
$data['id'] = $data['term_id'];
}
return $data;
}
protected static function get_field_keys(){
return ['name', 'parent', 'slug', 'description', 'alias_of'];
}
public static function insert($data){
$result = static::validate_data($data);
if(is_wp_error($result)){
return $result;
}
if(isset($data['taxonomy'])){
$taxonomy = $data['taxonomy'];
if(!taxonomy_exists($taxonomy)){
return new WP_Error('invalid_taxonomy');
}
}else{
$taxonomy = self::get_current_taxonomy();
}
$data = static::sanitize_data($data);
$meta_input = array_pull($data, 'meta_input');
$name = array_pull($data, 'name');
$args = wp_array_slice_assoc($data, self::get_field_keys());
$result = wp_insert_term(wp_slash($name), $taxonomy, wp_slash($args));
if(!is_wp_error($result)){
if($meta_input){
wpjam_update_metadata('term', $result['term_id'], $meta_input);
}
return $result['term_id'];
}
return $result;
}
public static function update($term_id, $data, $validate=true){
if($validate){
$term = self::validate($term_id);
if(is_wp_error($term)){
return $term;
}
}
$result = static::validate_data($data, $term_id);
if(is_wp_error($result)){
return $result;
}
$taxonomy = $data['taxonomy'] ?? get_term_taxonomy($term_id);
$data = static::sanitize_data($data);
$meta_input = array_pull($data, 'meta_input');
$args = wp_array_slice_assoc($data, self::get_field_keys());
$result = $args ? wp_update_term($term_id, $taxonomy, wp_slash($args)) : true;
if(!is_wp_error($result) && $meta_input){
wpjam_update_metadata('term', $term_id, $meta_input);
}
return $result;
}
public static function delete($term_id){
$object = self::get_instance($term_id, null, true);
$result = is_wp_error($object) ? $object : $object->is_deletable();
return is_wp_error($result) ? $result : wp_delete_term($term_id, $object->taxonomy);
}
protected static function validate_data($data, $term_id=0){
return true;
}
protected static function sanitize_data($data, $term_id=0){
return $data;
}
public static function get_meta($term_id, ...$args){
// _deprecated_function(__METHOD__, 'WPJAM Basic 6.0', 'wpjam_get_metadata');
return wpjam_get_metadata('term', $term_id, ...$args);
}
public static function update_meta($term_id, ...$args){
// _deprecated_function(__METHOD__, 'WPJAM Basic 6.0', 'wpjam_update_metadata');
return wpjam_update_metadata('term', $term_id, ...$args);
}
public static function update_metas($term_id, $data, $meta_keys=[]){
// _deprecated_function(__METHOD__, 'WPJAM Basic 6.0', 'wpjam_update_metadata');
return self::update_meta($term_id, $data, $meta_keys);
}
public static function get_by_ids($term_ids){
return self::update_caches($term_ids);
}
public static function update_caches($term_ids){
if($term_ids){
$term_ids = array_filter($term_ids);
$term_ids = array_unique($term_ids);
}
if(empty($term_ids)) {
return [];
}
_prime_term_caches($term_ids, false);
$tids = [];
$cache_values = wp_cache_get_multiple($term_ids, 'terms');
foreach($term_ids as $term_id){
if(empty($cache_values[$term_id])){
wp_cache_add($term_id, false, 'terms', 10); // 防止大量 SQL 查询。
}else{
$tids[] = $term_id;
}
}
wpjam_lazyload('term_meta', $tids);
return $cache_values;
}
public static function get_term($term, $taxonomy='', $output=OBJECT, $filter='raw'){
if($term && is_numeric($term)){
$found = false;
$cache = wp_cache_get($term, 'terms', false, $found);
if($found){
if(is_wp_error($cache)){
return $cache;
}elseif(!$cache){
return null;
}
}else{
$_term = WP_Term::get_instance($term, $taxonomy);
if(is_wp_error($_term)){
return $_term;
}elseif(!$_term){ // 不存在情况下的缓存优化，防止重复 SQL 查询。
wp_cache_add($term, false, 'terms', 10);
return null;
}
}
}
return get_term($term, $taxonomy, $output, $filter);
}
public static function get_current_taxonomy(){
$object = WPJAM_Taxonomy::get_by_model(get_called_class(), 'WPJAM_Term');
return $object ? $object->name : null;
}
public static function validate($term_id, $taxonomy=null){
$term = self::get_term($term_id);
if(is_wp_error($term)){
return $term;
}elseif(!$term || !($term instanceof WP_Term)){
return new WP_Error('invalid_term');
}
if(!taxonomy_exists($term->taxonomy)){
return new WP_Error('invalid_taxonomy');
}
$taxonomy = $taxonomy ?? self::get_current_taxonomy();
if($taxonomy && $taxonomy !== 'any' && !in_array($term->taxonomy, (array)$taxonomy)){
return new WP_Error('invalid_taxonomy');
}
return $term;
}
public static function filter_fields($fields, $id){
if($id && !is_array($id)){
$object = self::get_instance($id);
if($object && $object->tax_object){
$fields = array_merge(['name'=>[
'title' => $object->tax_object->label,
'type' => 'view',
'value' => $object->name
]], $fields);
}
}
return $fields;
}
}
class WPJAM_Taxonomy extends WPJAM_Register{
public function __get($key){
if($key != 'name' && property_exists('WP_Taxonomy', $key)){
$object = get_taxonomy($this->name);
if($object){
return $object->$key;
}
}
$value = parent::__get($key);
if($key == 'model' && (!$value || !class_exists($value) || !is_subclass_of($value, 'WPJAM_Term'))){
return 'WPJAM_Term';
}
return $value;
}
public function __set($key, $value){
if($key != 'name' && property_exists('WP_Taxonomy', $key)){
$object = get_taxonomy($this->name);
if($object){
$object->$key = $value;
}
}
parent::__set($key, $value);
}
protected function preprocess_args($args){
$args = parent::preprocess_args($args);
$args = wp_parse_args($args, ['_jam'=>true]);
if($args['_jam']){
$args = wp_parse_args($args, [
'rewrite' => true,
'show_ui' => true,
'show_in_nav_menus' => false,
'show_admin_column' => true,
'hierarchical' => true,
]);
}
if(empty($args['supports'])){
$args['supports'] = ['slug', 'description', 'parent'];
}
if($this->name == 'category'){
$args['plural'] = 'categories';
$args['column_name'] = 'categories';
}elseif($this->name == 'post_tag'){
$args['plural'] = 'post_tags';
$args['column_name'] = 'tags';
}else{
if(empty($args['plural'])){
$args['plural'] = $this->name.'s';
}
$args['column_name'] = 'taxonomy-'.$this->name;
}
$args['id_query_var'] = wpjam_get_taxonomy_query_key($this->name);
return $args;
}
public function to_array(){
$this->filter_args();
if(doing_filter('register_taxonomy_args')){
if($this->permastruct){
$this->permastruct = str_replace('%term_id%', '%'.$this->name.'_id%', $this->permastruct);
if(strpos($this->permastruct, '%'.$this->name.'_id%')){
$this->supports = array_diff($this->supports, ['slug']);
$this->query_var = $this->query_var ?? false;
}
$this->rewrite = $this->rewrite ?: true;
}
if($this->levels == 1){
$this->supports = array_diff($this->supports, ['parent']);
}else{
$this->supports = array_merge($this->supports, ['parent']);
}
if($this->rewrite && $this->_jam){
$this->rewrite = is_array($this->rewrite) ? $this->rewrite : [];
$this->rewrite = wp_parse_args($this->rewrite, ['with_front'=>false, 'hierarchical'=>false]);
}
}
return $this->args;
}
public function get_fields($id=0, $action_key=''){
$fields = [];
if($action_key == 'set'){
$fields['name'] = ['title'=>'名称', 'type'=>'text', 'class'=>'', 'required'];
if($this->supports('slug')){
$fields['slug'] = ['title'=>'别名', 'type'=>'text', 'class'=>'', 'required'];
}
if($this->hierarchical && $this->levels !== 1 && $this->supports('parent')){
$args = ['taxonomy'=>$this->taxonomy, 'hide_empty'=>0, 'format'=>'flat'];
$depth = null;
if($this->levels > 1){
$depth = $this->levels - 1 - wpjam_term($id)->depth;
if(!$depth){
$args['parent'] = -1;
$depth = null;
}
}
$terms = wpjam_get_terms($args, $depth);
$options = $terms ? array_column($terms, 'name', 'id') : [];
$fields['parent'] = ['title'=>'父级', 'type'=>'select', 'options'=> ['-1'=>'无']+$options];
}
if($this->supports('description')){
$fields['description'] = ['title'=>'描述', 'type'=>'textarea'];
}
}
if($this->supports('thumbnail')){
$fields['thumbnail'] = [
'title' => '缩略图',
'type' => $this->thumbnail_type == 'image' ? 'image' : 'img',
'item_type' => $this->thumbnail_type == 'image' ? 'image' : 'url',
'size' => $this->thumbnail_size,
'description' => $this->thumbnail_size ? '尺寸：'.$this->thumbnail_size : '',
];
}
if($this->supports('banner')){
$fields['banner'] = [
'title' => '大图',
'type' => 'img',
'item_type' => 'url',
'size' => $this->banner_size,
'description' => $this->banner_size ? '尺寸：'.$this->banner_size : '',
'show_if' => [
'key' => 'parent',
'value' => -1,
'external' => $action_key != 'set'
],
];
}
return array_merge($fields, $this->get_items('_fields'));
}
public function register_option($list_table=false){
if(!wpjam_get_term_option($this->name.'_base')){
wpjam_register_term_option($this->name.'_base', [
'taxonomy' => $this->name,
'title' => '快速编辑',
'submit_text' => '编辑',
'page_title' => '编辑'.$this->label,
'fields' => [$this, 'get_fields'],
'list_table' => $this->show_ui,
'action_name' => 'set',
'order' => 99,
]);
}
}
public function is_object_in($object_type){
return is_object_in_taxonomy($object_type, $this->name);
}
public function is_viewable(){
return is_taxonomy_viewable($this->name);
}
public function add_support($feature){
$this->supports = array_merge($this->supports, [$feature]);
return $this;
}
public function supports($feature){
return in_array($feature, $this->supports);
}
public function get_path($args){
$query_key = $this->id_query_var;
$term_id = $args['term_id'] ?? ($args[$query_key] ?? 0);
$term_id = (int)$term_id;
if(!$term_id){
return new WP_Error('invalid_term_id', [$this->label]);
}
if($args['platform'] == 'template'){
return get_term_link($term_id, $taxonomy);
}
return str_replace('%term_id%', $term_id, $args['path']);
}
public function get_id_field($args){
$title = $this->label;
$levels = $this->levels;
$type = $args['type'] ?? '';
$wrap = $args['wrap'] ?? false;
if($type == 'mu-text'){
$levels = 0;
}
if($this->hierarchical && ($levels > 1 || !is_admin() || (is_admin() && wp_count_terms(['taxonomy'=>$this->name]) <= 30))){
$option_all = array_pull($args, 'option_all', true);
if($option_all !== false){
$option_all = $option_all === true ? '请选择' : $option_all;
}
if($levels > 1 && $type == ''){
$fields = [];
for($level=0; $level < $levels; $level++){
if($level == 0){
$terms = wpjam_get_terms(['taxonomy'=>$this->name, 'hide_empty'=>0], 1);
$options = $terms ? array_column($terms, 'name', 'id') : [];
$show_if = [];
}else{
$options = [];
$show_if = ['key'=>'level_'.($level-1), 'compare'=>'!=', 'value'=>0, 'query_arg'=>'parent'];
}
if($option_all !== false){
$options = [''=>$option_all]+$options;
}
$sub_key = 'level_'.$level;
$fields[$sub_key] = [
'data-sub_key' => $sub_key,
'type' => 'select',
'options' => $options,
'show_if' => $show_if,
'show_in_rest' => ['type'=>'integer']
];
if($level > 0){
$fields[$sub_key] += [
'data_type' => 'taxonomy',
'taxonomy' => $this->name,
'wrap_class' => 'sublevel hidden',
'data' => ['option_all'=>$option_all],
];
}
}
$field = wp_parse_args($args, [
'title' => $title,
'type' => 'fields',
'fieldset_type' => 'array',
'class' => 'cascading-dropdown',
'fields' => $fields,
'data_type' => 'taxonomy',
'taxonomy' => $this->name,
'show_in_rest' => ['type'=>'integer']
]);
if($option_all === false){
$field['value'] = $fields['level_0']['options'] ? array_key_first($fields['level_0']['options']) : 0;
}
}else{
if($type == 'mu-text'){
$args['item_type'] = 'select';
}
$terms = wpjam_get_terms(['taxonomy'=>$this->name, 'hide_empty'=>0, 'format'=>'flat']);
$options = $terms ? array_column($terms, 'name', 'id') : [];
if($option_all){
$options = [''=>$option_all]+$options;
}
$field = wp_parse_args($args, [
'title' => $title,
'type' => 'select',
'options' => $options,
'show_in_rest' => ['type'=>'integer']
]);
}
}else{
$field = wp_parse_args($args, [
'title' => $title,
'type' => 'text',
'class' => 'all-options',
'data_type' => 'taxonomy',
'taxonomy' => $this->name,
'placeholder' => '请输入'.$title.'ID或者输入关键字筛选',
'show_in_rest' => ['type'=>'integer']
]);
}
return $wrap ? [$this->id_query_var => $field] : $field;
}
public function get_mapping($post_id){
$post = wpjam_validate_post($post_id, $this->mapping_post_type);
if(is_wp_error($post)){
return $post;
}
$post_type = $post->post_type;
$meta_key = $this->name.'_id';
$term_id = get_post_meta($post_id, $meta_key, true);
$data = ['name'=>$post->post_title, 'slug'=>$post_type.'-'.$post_id, 'taxonomy'=>$this->name];
if($term_id){
$term = get_term($term_id, $this->name);
if($term){
if($term->name != $data['name'] || $term->slug != $data['slug']){
WPJAM_Term::update($term_id, $data);
}
return $term_id;
}
}
$term_id = WPJAM_Term::insert($data);
if(!is_wp_error($term_id)){
update_post_meta($post_id, $meta_key, $term_id);
}
return $term_id;
}
public function dropdown(){
$query_key = $this->id_query_var;
$selected = wpjam_get_data_parameter($query_key);
if(is_null($selected)){
if($this->query_var){
$term_slug = wpjam_get_data_parameter($this->query_var);
}elseif(wpjam_get_data_parameter('taxonomy') == $this->name){
$term_slug = wpjam_get_data_parameter('term');
}else{
$term_slug = '';
}
$term = $term_slug ? get_term_by('slug', $term_slug, $this->name) : null;
$selected = $term ? $term->term_id : '';
}
if($this->hierarchical){
wp_dropdown_categories([
'taxonomy' => $this->name,
'show_option_all' => $this->labels->all_items,
'show_option_none' => '没有设置',
'option_none_value' => 'none',
'name' => $query_key,
'selected' => $selected,
'hierarchical' => true
]);
}else{
echo wpjam_field([
'key' => $query_key,
'value' => $selected,
'type' => 'text',
'data_type' => 'taxonomy',
'taxonomy' => $this->name,
'placeholder' => '请输入'.$this->label,
'title' => '',
'class' => ''
]);
}
}
public function registered_callback($taxonomy, $object_type, $args){
if($this->name == $taxonomy){
if($this->permastruct){
if(strpos($this->permastruct, '%'.$taxonomy.'_id%')){
add_rewrite_tag('%'.$taxonomy.'_id%', '([^/]+)', 'taxonomy='.$taxonomy.'&term_id=');
remove_rewrite_tag('%'.$taxonomy.'%');
}
if($this->permastruct == '%'.$taxonomy.'%'){
add_filter('request', [$this, 'filter_request']);
}else{
add_permastruct($taxonomy, $this->permastruct, $args['rewrite']);
}
add_filter('pre_term_link', [$this, 'filter_link'], 1, 2);
}
if($this->registered_callback && is_callable($this->registered_callback)){
call_user_func($this->registered_callback, $taxonomy, $object_type, $args);
}
}
}
public function filter_labels($labels){
$_labels = (array)($this->labels ?? []);
$labels = (array)$labels;
$name = $labels['name'];
if($this->hierarchical){
$search = ['目录', '分类', 'categories', 'Categories', 'Category'];
$replace = ['', $name, $name, $name.'s', ucfirst($name).'s', ucfirst($name)];
}else{
$search = ['标签', 'Tag', 'tag'];
$replace = [$name, ucfirst($name), $name];
}
foreach($labels as $key => &$label){
if($label && empty($_labels[$key]) && $label != $name){
$label = str_replace($search, $replace, $label);
}
}
return $labels;
}
public function filter_request($query_vars){
$structure = get_option('permalink_structure');
$request = $GLOBALS['wp']->request;
if($structure && $request && !isset($query_vars['module'])){
$key = null;
if($GLOBALS['wp_rewrite']->use_verbose_page_rules){
if(str_starts_with($structure, '/%postname%')){
$key = 'name';
}elseif(str_starts_with($structure, '/%author%')){
if(!str_starts_with($request, 'author/')){
$key = 'author_name';
}
}elseif(str_starts_with($structure, '/%category%')){
if(!str_starts_with($request, 'category/') && $this->name != 'category'){
$key = 'category_name';
}
}
}else{
if(!empty($query_vars['pagename'])
&& !isset($_GET['page_id'])
&& !isset($_GET['pagename'])
){
$key = 'pagename';
}
}
$name = $key ? ($query_vars[$key] ?? '') : '';
$name = wp_basename(strtolower($name));
if($name){
$terms = wpjam_get_all_terms($this->name);
if($terms && in_array($name, array_column($terms, 'slug'))){
unset($query_vars[$key]);
if($this->name == 'category'){
$query_vars['category_name'] = $name;
}else{
$query_vars['taxonomy'] = $this->name;
$query_vars['term'] = $name;
}
}
}
}
return $query_vars;
}
public function filter_link($term_link, $term){
if($term->taxonomy == $this->name){
if(strpos($this->permastruct, '%'.$this->name.'_id%')){
$term_link = str_replace('%'.$this->name.'_id%', $term->term_id, $term_link);
}elseif($this->permastruct == '%'.$this->name.'%'){
$term_link = $this->permastruct;
}
}
return $term_link;
}
public function registered(){
wpjam_load('init', function(){
add_action('registered_taxonomy_'.$this->name, [$this, 'registered_callback'], 10, 3);
if($this->_jam){
if(is_admin() && $this->show_ui){
add_filter('taxonomy_labels_'.$this->name, [$this, 'filter_labels']);
}
register_taxonomy($this->name, $this->object_type, $this->to_array());
}
});
}
public static function filter_register_args($args, $taxonomy, $object_type){
if(did_action('init') || empty($args['_builtin'])){
$object = self::get($taxonomy);
if($object){
$object->update_args($args);
}else{
$args = array_merge($args, ['_jam'=>false, 'object_type'=>$object_type]);
$object = self::register($taxonomy, $args);
}
return $object->to_array();
}
return $args;
}
protected static function get_config($key){
if(in_array($key, ['menu_page', 'admin_load', 'register_json'])){
return true;
}
}
}
class WPJAM_Terms{
public static function parse($args, $max_depth=null){
if(is_string($args) || wp_is_numeric_array($args)){
$term_ids = wp_parse_id_list($args);
if(!$term_ids){
return [];
}
$args = ['orderby'=>'include', 'include'=>$term_ids];
$max_depth = -1;
}
if($max_depth != -1){
$taxonomy = $args['taxonomy'] ?? '';
$tax_object = ($taxonomy && is_string($taxonomy)) ? wpjam_get_taxonomy_object($taxonomy) : null;
if(!$tax_object){
return [];
}
if($tax_object->hierarchical){
$max_depth = $max_depth ?? (int)$tax_object->levels;
}else{
$max_depth = -1;
}
if(isset($args['child_of'])){
$parent = $args['child_of'];
}else{
$parent = array_pull($args, 'parent');
if($parent){
$args['child_of'] = $parent;
}
}
}
$format = array_pull($args, 'format');
$args = wp_parse_args($args, ['hide_empty'=>false]);
$terms = get_terms($args) ?: [];
if(is_wp_error($terms) || empty($terms)){
return $terms;
}
if($max_depth != -1){
$top_level = $children = [];
if($parent){
$top_level[] = get_term($parent);
}
foreach($terms as $term){
if($term->parent == 0){
$top_level[] = $term;
}elseif($max_depth != 1){
$children[$term->parent][] = $term;
}
}
$output = [];
foreach($top_level as $term){
$object = wpjam_term($term);
$parsed = $object->parse_with_children($children, $max_depth, 0, $format);
$output = array_merge($output, $parsed);
}
return $output;
}else{
foreach($terms as &$term){
$object = wpjam_term($term);
$term = $object->parse_for_json();
}
return $terms;
}
}
public static function parse_json_module($args){
$tax_object = wpjam_get_taxonomy_object(array_get($args, 'taxonomy'));
if(!$tax_object){
wp_die('invalid_taxonomy');
}
$mapping = array_pull($args, 'mapping');
$mapping = $mapping ? wp_parse_args($mapping) : [];
if($mapping && is_array($mapping)){
foreach($mapping as $key => $get){
$value = wpjam_get_parameter($get);
if($value){
$args[$key] = $value;
}
}
}
$number = (int)array_pull($args, 'number');
$output = array_pull($args, 'output');
$output = $output ?: $tax_object->plural;
$max_depth = array_pull($args, 'max_depth');
$terms = self::parse($args, $max_depth);
if($terms && $number){
$paged = array_pull($args, 'paged') ?: 1;
$offset = $number * ($paged-1);
$terms_json['current_page'] = (int)$paged;
$terms_json['total_pages'] = ceil(count($terms)/$number);
$terms = array_slice($terms, $offset, $number);
}
$terms = $terms ? array_values($terms) : [];
return [$output => $terms];
}
public static function cleanup(){
// term_relationships 的 object_id 可能不是 post_id
// 如果要清理需要具体业务逻辑的时候，进行清理。
$wpdb = $GLOBALS['wpdb'];
$results = $wpdb->get_results("SELECT tr.* FROM {$wpdb->term_relationships} tr LEFT JOIN {$wpdb->term_taxonomy} tt ON tr.term_taxonomy_id = tt.term_taxonomy_id WHERE tt.term_taxonomy_id is NULL;");
if($results){
$wpdb->query("DELETE tr FROM {$wpdb->term_relationships} tr LEFT JOIN {$wpdb->term_taxonomy} tt ON tr.term_taxonomy_id = tt.term_taxonomy_id WHERE tt.term_taxonomy_id is NULL;");
}
return $results;
}
}