Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Feature: Support arbitrary front matter metadata, categories, tags, author, featured image and SEO fields

Abierto
#87 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
25/100
Tipo de issue
Nueva funcionalidad
Claridad
Necesita aclaración
Estado de actividad
Tranquilo
Stack tecnológico
php, wordpress
Área
backend, content

Línea de trabajo

No se nombran archivos de implementación ni pruebas; empieza por localizar los puntos de entrada existentes para front-matter checkout, import/export y push-validation, y después revisa los nombres de hook y las reglas de permisos propuestas. Se considera terminado cuando se cubren los criterios de aceptación indicados, incluidos los formatos de lista, los términos jerárquicos, la validación estricta, las asignaciones SEO y que no se creen ni eliminen autores.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Summary

Push MD supports a fixed set of basic front matter keys (title, date, status, description). We should add support for arbitrary front matter metadata key-values. To begin, create hooks for front matter meta data, and add support for hierarchical categories, tags, author attribution, featured image, and SEO fields, complete with strict push validation to prevent typos.

We can create "master" reference files for categories etc, and support CRUD based on changes in these files. All this should respect the user permissions though. Special case: for authors - no create / delete support.

Features & How They Should Work
  1. Extensible Arbitrary Front Matter Meta Support (Primary Feature):

    • Add developer hook framework allowing any custom post meta or third-party plugin metadata to be registered, exported, and imported via Markdown front matter:
      • push_md_supported_frontmatter_keys
      • push_md_export_frontmatter
      • push_md_import_frontmatter
      • push_md_export_author & push_md_import_author
  2. Master Reference Files & Strict Validation:

    • Generate categories.md, tags.md, and authors.md during checkout/seed.
    • Pushing a post with an unknown category, tag, or author that is not in WordPress or the reference files should trigger a strict validation error to prevent typos.
  3. Categories, Tags, Authors & Featured Image:

    • categories: Support YAML lists, JSON arrays (["Cat A", "Cat B"]), or comma-separated strings. Full support for hierarchical category paths using "Parent > Child" (e.g., Tech > WordPress).
    • tags: Support YAML/JSON lists or comma-separated tag strings.
    • author: Match author by display name, username (user_login), nicename, or email address.
    • featured_image: Resolve local path or attachment URL to WordPress attachment ID.
  4. Built-in SEO Metadata:

    • Build on top of the front matter hooks: supports seo_title, seo_description, and seo_focus_keyword.
    • Automatically map to Rank Math or Yoast SEO post meta depending on which plugin is active.
Acceptance Criteria
  • Custom front matter keys can be registered via push_md_supported_frontmatter_keys.
  • Front matter list parser supports YAML lists, JSON arrays, and comma-separated strings.
  • Hierarchical categories (Parent > Child) parse and map correctly.
  • Unknown terms/authors trigger a push validation error.
  • Permission checks
  • SEO fields map automatically to Rank Math / Yoast SEO meta.
  • No creation or deletion of users from authors.md sync. Only updates.
Lenguaje dominante
PHP
Estrellas
22
Forks
5
Métricas de merge de PR
Sin PR fusionados en 30 d

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de Automattic/php-toolkit

Todos los issues de Automattic/php-toolkit

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.