{"id":233559,"date":"2023-02-17T12:38:00","date_gmt":"2023-02-17T09:38:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=233559"},"modified":"2022-11-11T00:20:59","modified_gmt":"2022-11-10T21:20:59","slug":"cree-tipos-de-publicaciones-personalizadas-y-taxonomias-personalizadas-en-wordpress-por-codigo","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/es\/cree-tipos-de-publicaciones-personalizadas-y-taxonomias-personalizadas-en-wordpress-por-codigo\/","title":{"rendered":"Cree tipos de publicaciones personalizadas y taxonom\u00edas personalizadas en WordPress por c\u00f3digo"},"content":{"rendered":"\n

Este es un tutorial sobre c\u00f3mo crear un tipo de publicaci\u00f3n personalizada y una taxonom\u00eda personalizada en WordPress por c\u00f3digo. Veremos las trampas comunes y qu\u00e9 argumentos usar para una creaci\u00f3n m\u00ednima pero suficiente. Ejemplo completo incluido al final.<\/p>\n

D\u00f3nde agregar el c\u00f3digo<\/h2>\n

La creaci\u00f3n de tipos de publicaciones personalizadas (CPT) y taxonom\u00edas personalizadas en WordPress se puede realizar dentro del functions.php<\/code>archivo de un tema o dentro de un complemento. Tenga en cuenta que el tipo de publicaci\u00f3n personalizada y la taxonom\u00eda personalizada desaparecer\u00e1n si cambia de tema o desactiva el complemento. Por lo tanto, es seguro eliminar temporalmente el registro de CPT del tema y moverlo a un complemento, siempre que mantenga el mismo tipo de publicaci\u00f3n personalizada o identificador de taxonom\u00eda slug\/ID.<\/p>\n

Para crear (y modificar) un CPT o una taxonom\u00eda, utilice siempre<\/strong> el init<\/code>gancho. Colocarlo en la ra\u00edz de functions.php<\/code>(fuera de un anzuelo) o cualquier otro anzuelo causar\u00e1 problemas.<\/p>\n

Crear un tipo de publicaci\u00f3n personalizada<\/h2>\n

Para crear un tipo de publicaci\u00f3n personalizada, use la register_post_type<\/code>funci\u00f3n. Acepta dos par\u00e1metros; primero el identificador de tipo de publicaci\u00f3n y segundo una matriz con todos los argumentos.<\/p>\n

El identificador de tipo de publicaci\u00f3n es un nombre de versi\u00f3n slug de su tipo de publicaci\u00f3n. Por ejemplo, los tipos de publicaciones y p\u00e1ginas integradas de WordPress se identifican como ‘ post<\/code>‘ y ‘ page<\/code>‘. El identificador debe ser \u00fanico, debe seguir un conjunto de reglas (min\u00fasculas, sin espacios, etc.) y no ser uno de los slugs reservados de WordPress.<\/p>\n

Esto es lo que he aprendido a ser los argumentos m\u00ednimos pero perfectamente buenos para registrar un tipo de publicaci\u00f3n; teniendo en cuenta que es un CPT p\u00fablico normal y desea anular cualquier etiqueta que diga "publicaci\u00f3n" o "p\u00e1gina" con el nombre real de su CPT:<\/p>\n

add_action('init', function() {\n    register_post_type('book', [\n        'label' => __('Books', 'txtdomain'),\n        'public' => true,\n        'menu_position' => 5,\n        'menu_icon' => 'dashicons-book',\n        'supports' => ['title', 'editor', 'thumbnail', 'author', 'revisions', 'comments'],\n        'show_in_rest' => true,\n        'rewrite' => ['slug' => 'book'],\n        'labels' => [\n            'singular_name' => __('Book', 'txtdomain'),\n            'add_new_item' => __('Add new book', 'txtdomain'),\n            'new_item' => __('New book', 'txtdomain'),\n            'view_item' => __('View book', 'txtdomain'),\n            'not_found' => __('No books found', 'txtdomain'),\n            'not_found_in_trash' => __('No books found in trash', 'txtdomain'),\n            'all_items' => __('All books', 'txtdomain'),\n            'insert_into_item' => __('Insert into book', 'txtdomain')\n        ],      \n    ]);\n});<\/code><\/pre>\n
Una visi\u00f3n general de los argumentos.<\/h3>\n
Tenga en cuenta que algunos de los argumentos heredan valores de otros argumentos. A menos que se establezcan expl\u00edcitamente, pueden tener el mismo valor predeterminado o el opuesto a otro. Varios argumentos heredan el mismo valor o el opuesto del argumento public<\/code>. Lea la documentaci\u00f3n<\/a> para ver cu\u00e1l es el valor predeterminado para cada argumento y si necesita anularlo.<\/p>\n
Si est\u00e1 de acuerdo con tener textos en el administrador que se refieran a su tipo de publicaci\u00f3n como "publicaci\u00f3n" o "p\u00e1gina", puede omitir la definici\u00f3n de los argumentos de la etiqueta. Probablemente estar\u00e1 bien con solo label<\/code>(nombre plural) y dentro de la labels<\/code>matriz solo singular_name<\/code>(nombre singular).<\/p>\n
Si no establece expl\u00edcitamente show_in_rest<\/code>en verdadero, su tipo de posici\u00f3n personalizada utilizar\u00e1 el antiguo editor cl\u00e1sico. Si desea utilizar el editor Gutenberg para su tipo de publicaci\u00f3n personalizada, debe establecerlo show_in_rest<\/code>en true<\/strong>.<\/p>\n
El supports<\/code>argumento indica qu\u00e9 elementos est\u00e1n disponibles al editar una publicaci\u00f3n en su tipo de publicaci\u00f3n. Como m\u00ednimo, probablemente desee el t\u00edtulo, el editor y la imagen destacada de la publicaci\u00f3n.<\/p>\n
El rewrite<\/code>argumento con el m\u00ednimo de elemento de matriz slug<\/code>le dice a WordPress que reescriba todas las publicaciones singulares de su tipo de publicaci\u00f3n para usar este slug de prefijo. En el ejemplo anterior, una publicaci\u00f3n de libro singular obtendr\u00eda una URL como; \u00bb http:\/\/ejemplo.com\/libro\/i-robot\/<\/a> \u00ab. Si est\u00e1 interesado en c\u00f3mo agregar una configuraci\u00f3n de regla de enlace permanente en el administrador para permitir que los usuarios del tema decidan este slug por s\u00ed mismos, eche un vistazo a esta publicaci\u00f3n<\/a>.<\/p>\n
El argumento para el \u00edcono de men\u00fa (menu_icon<\/code>) puede ser cualquiera de los siguientes Dashicons<\/a>, o puede dejarlo vac\u00edo para mantener el valor predeterminado. El valor predeterminado es el mismo icono que Publicaciones. Sin embargo, es una buena idea separar claramente los tipos de publicaciones personalizadas.<\/p>\n
La posici\u00f3n del men\u00fa (menu_position<\/code>) le permite decidir la posici\u00f3n de su tipo de publicaci\u00f3n personalizada en el men\u00fa de administraci\u00f3n. La documentaci\u00f3n enumera todas las posiciones del men\u00fa de administraci\u00f3n, para que pueda ajustar; la posici\u00f3n 5 est\u00e1 justo despu\u00e9s de ‘Publicaciones’.<\/p>\n
Hay otro argumento (taxonomies<\/code>) para adjuntar una taxonom\u00eda al tipo de publicaci\u00f3n. Veremos c\u00f3mo agregar una taxonom\u00eda personalizada m\u00e1s adelante en esta publicaci\u00f3n. Para agregar taxonom\u00edas a su tipo de publicaci\u00f3n, agregue este argumento a la matriz anterior;<\/p>\n
'taxonomies' => ['book_author'],<\/code><\/pre>\n
Una nota sobre los enlaces permanentes y los errores 404 no encontrados<\/h3>\n
Despu\u00e9s de haber agregado su c\u00f3digo para registrar un tipo de publicaci\u00f3n personalizada, notar\u00e1 que ver una sola publicaci\u00f3n devolver\u00e1 el error "404 no encontrado". Esto se debe a que necesita "actualizar enlaces permanentes".<\/p>\n
Vaya a Configuraci\u00f3n > Enlaces permanentes y simplemente haga clic en el bot\u00f3n "Guardar cambios" (no es necesario cambiar nada).<\/p>\n
Tenga en cuenta que cada vez que cambie el rewrite<\/code>atributo, deber\u00e1 actualizar los enlaces permanentes nuevamente.<\/p>\n
Creaci\u00f3n de una taxonom\u00eda personalizada<\/h2>\n
Se puede adjuntar una taxonom\u00eda personalizada a uno de los tipos de publicaciones de WordPress (publicaciones, p\u00e1ginas) o a un tipo de publicaci\u00f3n personalizado. Tambi\u00e9n puede adjuntar varias taxonom\u00edas a un tipo de publicaci\u00f3n. Cuando registra una taxonom\u00eda, debe proporcionar los tipos de publicaci\u00f3n a los que desea que se adjunte.<\/p>\n
Una taxonom\u00eda puede ser jer\u00e1rquica (como categor\u00edas de publicaciones en las que puede crear una estructura basada en \u00e1rboles) o basada en etiquetas (como etiquetas de publicaciones). Esta es realmente la \u00fanica consideraci\u00f3n que necesita saber de antemano, con la excepci\u00f3n de su identificador slug. Al igual que con los CPT, el slug de identificaci\u00f3n de una taxonom\u00eda debe ser \u00fanico y seguir un conjunto de reglas.<\/p>\n
Para registrar una taxonom\u00eda personalizada, utilice la register_taxonomy<\/code>funci\u00f3n. Acepta el register_taxonomy<\/code>slug del identificador \u00fanico de taxonom\u00eda como primer argumento, una matriz de tipos de publicaciones para adjuntarla como segundo argumento y, finalmente, una matriz con el resto de los argumentos. Hay muchos argumentos, pero esto es lo que he experimentado como m\u00ednimo pero suficiente para registrar una taxonom\u00eda personalizada (esto agrega una taxonom\u00eda de tipo etiqueta\/no jer\u00e1rquica):<\/p>\n
add_action('init', function() {\n    register_taxonomy('book_author', ['book'], [\n        'label' => __('Authors', 'txtdomain'),\n        'hierarchical' => false,\n        'rewrite' => ['slug' => 'book-author'],\n        'show_admin_column' => true,\n        'show_in_rest' => true,\n        'labels' => [\n            'singular_name' => __('Author', 'txtdomain'),\n            'all_items' => __('All Authors', 'txtdomain'),\n            'edit_item' => __('Edit Author', 'txtdomain'),\n            'view_item' => __('View Author', 'txtdomain'),\n            'update_item' => __('Update Author', 'txtdomain'),\n            'add_new_item' => __('Add New Author', 'txtdomain'),\n            'new_item_name' => __('New Author Name', 'txtdomain'),\n            'search_items' => __('Search Authors', 'txtdomain'),\n            'popular_items' => __('Popular Authors', 'txtdomain'),\n            'separate_items_with_commas' => __('Separate authors with comma', 'txtdomain'),\n            'choose_from_most_used' => __('Choose from most used authors', 'txtdomain'),\n            'not_found' => __('No Authors found', 'txtdomain'),\n        ]\n    ]);\n});<\/code><\/pre>\n
Se recomienda agregar una llamada de funci\u00f3n justo despu\u00e9s del register_taxonomy<\/code>, para asegurarse de que se "adjunte" correctamente al CPT: register_taxonomy_for_object_type<\/code>. Defina su taxonom\u00eda como primer argumento y el CPT como segundo:<\/p>\n
register_taxonomy_for_object_type('book_author', 'book');<\/code><\/pre>\n
De manera similar al tipo de publicaci\u00f3n anterior, register_taxonomy<\/code>acepta muchos m\u00e1s argumentos, y muchos de ellos heredan o dependen del valor de otros argumentos. Lea la documentaci\u00f3n<\/a> para ver cu\u00e1l es el valor predeterminado para cada argumento y si necesita anularlo.<\/p>\n
Una visi\u00f3n general de los argumentos.<\/h3>\n
Si est\u00e1 de acuerdo con tener textos que se refieran a su taxonom\u00eda como "etiqueta" (si jer\u00e1rquico es falso) o "categor\u00eda" (si jer\u00e1rquico es verdadero), probablemente pueda omitir toda la labels<\/code>matriz con la excepci\u00f3n de quiz\u00e1s singular_name<\/code>.<\/p>\n
Es show_admin_column<\/code>\u00fatil para agregar una columna que muestre los t\u00e9rminos asociados en su taxonom\u00eda en la pantalla de administraci\u00f3n de CPT. Al igual que en Publicaciones, ver\u00e1 una columna que muestra las categor\u00edas asociadas. Este argumento est\u00e1 configurado de forma predeterminada en false<\/code>(no mostrar columna), por lo que me gusta anularlo.<\/p>\n
La configuraci\u00f3n show_in_rest<\/code>en verdadero es necesaria para que su taxonom\u00eda sea visible en la edici\u00f3n posterior en el editor de Gutenberg, ya que Gutenberg se basa en la API REST.<\/p>\n
Del mismo modo que con los tipos de publicaciones personalizadas, probablemente obtendr\u00e1 errores "404 no encontrado" en su taxonom\u00eda personalizada. Vaya a Configuraci\u00f3n > Enlaces permanentes y simplemente haga clic en el bot\u00f3n "Guardar cambios".<\/p>\n
C\u00f3digo de ejemplo completo<\/h2>\n
Aqu\u00ed hay un ejemplo completo de c\u00f3mo crear un CPT para libros y adjuntar dos taxonom\u00edas personalizadas; g\u00e9nero (jer\u00e1rquico) y autor del libro (etiqueta).<\/p>\n
add_action('init', function() {\n    register_post_type('book', [\n        'label' => __('Books', 'txtdomain'),\n        'public' => true,\n        'menu_position' => 5,\n        'menu_icon' => 'dashicons-book',\n        'supports' => ['title', 'editor', 'thumbnail', 'author', 'revisions', 'comments'],\n        'show_in_rest' => true,\n        'rewrite' => ['slug' => 'book'],\n        'taxonomies' => ['book_author', 'book_genre'],\n        'labels' => [\n            'singular_name' => __('Book', 'txtdomain'),\n            'add_new_item' => __('Add new book', 'txtdomain'),\n            'new_item' => __('New book', 'txtdomain'),\n            'view_item' => __('View book', 'txtdomain'),\n            'not_found' => __('No books found', 'txtdomain'),\n            'not_found_in_trash' => __('No books found in trash', 'txtdomain'),\n            'all_items' => __('All books', 'txtdomain'),\n            'insert_into_item' => __('Insert into book', 'txtdomain')\n        ],      \n    ]);\n\u00a0\n    register_taxonomy('book_genre', ['book'], [\n        'label' => __('Genres', 'txtdomain'),\n        'hierarchical' => true,\n        'rewrite' => ['slug' => 'book-genre'],\n        'show_admin_column' => true,\n        'show_in_rest' => true,\n        'labels' => [\n            'singular_name' => __('Genre', 'txtdomain'),\n            'all_items' => __('All Genres', 'txtdomain'),\n            'edit_item' => __('Edit Genre', 'txtdomain'),\n            'view_item' => __('View Genre', 'txtdomain'),\n            'update_item' => __('Update Genre', 'txtdomain'),\n            'add_new_item' => __('Add New Genre', 'txtdomain'),\n            'new_item_name' => __('New Genre Name', 'txtdomain'),\n            'search_items' => __('Search Genres', 'txtdomain'),\n            'parent_item' => __('Parent Genre', 'txtdomain'),\n            'parent_item_colon' => __('Parent Genre:', 'txtdomain'),\n            'not_found' => __('No Genres found', 'txtdomain'),\n        ]\n    ]);\n    register_taxonomy_for_object_type('book_genre', 'book');\n\u00a0\n    register_taxonomy('book_author', ['book'], [\n        'label' => __('Authors', 'txtdomain'),\n        'hierarchical' => false,\n        'rewrite' => ['slug' => 'book-author'],\n        'show_admin_column' => true,\n        'labels' => [\n            'singular_name' => __('Author', 'txtdomain'),\n            'all_items' => __('All Authors', 'txtdomain'),\n            'edit_item' => __('Edit Author', 'txtdomain'),\n            'view_item' => __('View Author', 'txtdomain'),\n            'update_item' => __('Update Author', 'txtdomain'),\n            'add_new_item' => __('Add New Author', 'txtdomain'),\n            'new_item_name' => __('New Author Name', 'txtdomain'),\n            'search_items' => __('Search Authors', 'txtdomain'),\n            'popular_items' => __('Popular Authors', 'txtdomain'),\n            'separate_items_with_commas' => __('Separate authors with comma', 'txtdomain'),\n            'choose_from_most_used' => __('Choose from most used Authors', 'txtdomain'),\n            'not_found' => __('No Authors found', 'txtdomain'),\n        ]\n    ]);\n    register_taxonomy_for_object_type('book_author', 'book');\n});<\/code><\/pre>\n
Fuente de grabaci\u00f3n:  awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Una gu\u00eda para crear tipos de publicaciones personalizadas y taxonom\u00edas personalizadas en WordPress por c\u00f3digo. Cubre los argumentos a utilizar para la creaci\u00f3n m\u00ednima pero suficiente.<\/p>\n","protected":false},"author":1,"featured_media":152888,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[924,892,892,716,716,914,1110,914,800,800,924,840,840,861,861],"tags":[1172],"class_list":{"0":"post-233559","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","6":"hentry","7":"category-asignaturas","8":"category-codigo","10":"category-desarrollador","12":"category-otro","13":"category-n-a","15":"category-php-2","18":"category-tutoriales","20":"category-wordpress-2","22":"tag-affiai-es"},"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts\/233559","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/comments?post=233559"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts\/233559\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/media\/152888"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/media?parent=233559"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/categories?post=233559"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/tags?post=233559"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}