¿Necesita agregar documentación a uno de sus sitios web de Divi? La documentación le permite proporcionar todo tipo de información útil a sus lectores y clientes. Pero debido a que la documentación es su propio tipo de contenido, probablemente no desee mezclar el contenido de la documentación con las publicaciones o páginas regulares de WordPress .
Entonces, para mostrarle cómo agregar documentación a WordPress (y, más específicamente, a una instalación de WordPress que ejecuta el tema Divi de WordPress ), le daré un tutorial rápido sobre cómo usar un nuevo complemento gratuito llamado DocuPress.
DocuPress es una herramienta gratuita para agregar documentación a cualquier sitio de WordPress. Está desarrollado por Robert DeVore y nació de la necesidad de Robert de una herramienta de documentación ligera para algunos de sus otros proyectos de desarrollo de WordPress.
Si bien hay muchas soluciones de base de conocimiento de trabajo pesado para WordPress, DocuPress es útil si solo está buscando agregar documentación básica a su sitio. Es decir, si no necesita montones de códigos cortos y análisis integrados.
Esto es lo que DocuPress realmente hace cuando lo instala:
- Crea un nuevo tipo de publicación personalizada de documentación
- Agrega una nueva taxonomía personalizada de Colecciones para dividir su documentación en diferentes categorías.
- Le brinda un widget que le permite mostrar fácilmente elementos de documentación en su barra lateral o en el contenido que crea con Divi Builder (u otras herramientas que le permiten mostrar widgets dentro de sus publicaciones).
En el futuro, Robert tiene planes de agregar algunos códigos abreviados básicos para brindarle aún más flexibilidad.
Si desea ver DocuPress en acción, puede consultar un ejemplo del mundo real en la documentación del complemento WP Dispensary de Robert .
Debemos enfatizar que este complemento es completamente nuevo. Si bien no está haciendo nada especialmente complejo, siempre debe tener esa mente antes de ir con todo de inmediato.
Cómo usar DocuPress para crear documentación
Ahora que sabe lo que hace, así es como puede usar DocuPress para crear documentación para su propio sitio de WordPress.
Paso 1: Instalar y activar DocuPress
DocuPress está disponible de forma gratuita en el repositorio de complementos de WordPress.org, por lo que puede instalarlo directamente desde su panel de control de WordPress.
Una vez que está instalado, no hay nada que necesite configurar. Recuerde: ¡esta es una solución ligera!
Paso 2: agregue sus colecciones de documentación
Una vez que active DocuPress, debería ver un nuevo tipo de publicación personalizada de Documentación . Pero antes de comenzar a agregar artículos de documentación, debe agregar algunas colecciones para categorizar sus artículos.
Para hacer eso, dirígete a Documentación → Colecciones . Complete los detalles y haga clic en Agregar nueva colección . Esto funciona de manera bastante idéntica a una categoría para una publicación normal de WordPress:
Agregue tantas colecciones como crea que necesita para dividir adecuadamente sus artículos de documentación.
Paso 3: agregue sus artículos de documentación
Una vez que tenga sus colecciones, diríjase a Documentación → Agregar nuevo para agregar artículos de documentación reales. Este es más o menos el editor de WordPress normal , excepto con una adición clave.
Asigne un título a su artículo e ingrese el contenido de la publicación. Luego, seleccione su Colección como lo haría con una categoría para una publicación normal de WordPress.
Lo único nuevo que debe hacer es elegir Atributos del artículo → Ordenar en la parte inferior derecha. Esto define el orden en que se muestran sus artículos en el widget. Por ejemplo:
- 0 se muestra primero
- 1 es el siguiente en la lista
- Etcétera.
Luego, asegúrese de publicar su artículo.
Repita el proceso para tantos artículos de documentación como necesite.
Paso 4: Muestre sus colecciones de documentación
Una vez que haya agregado todas sus colecciones y artículos, estará listo para mostrarlos en el front-end. Para hacer eso, puede usar el widget incluido para agregar listas de documentación a:
- tu barra lateral
- Contenido que creas con Divi Builder (u otra herramienta que te permita usar widgets en tu contenido)
La barra lateral es simple: solo diríjase a Apariencia → Widgets y arrastre sobre el widget Artículos de DocuPress :
Tu puedes elegir:
- El título que se muestra encima de la lista de artículos de documentación.
- Cuántos artículos de documentación mostrar
- Ya sea para mostrar todas las colecciones o una colección específica
- Si aleatorizar o no el orden de los artículos
Si desea mostrar sus listados de documentación en su contenido en lugar de su barra lateral, puede usar el Módulo de barra lateral de Divi en su lugar.
Para hacer eso, comience agregando un nuevo Widget en la parte inferior del área de Widgets:
Una vez que haga eso, tendrá una nueva área de la barra lateral de Documentación a la que puede agregar el widget de DocuPress:
Si desea mostrar diferentes secciones, puede agregar varios widgets de DocuPress a esta barra lateral.
Luego, diríjase a Divi Builder para la página a la que desea agregar su documentación. Agregue un nuevo módulo de barra lateral y seleccione el área de documentación que acaba de crear:
Luego, suponiendo que está utilizando el generador Visual , debería ver las categorías de su documentación:
Al igual que todos los módulos de Divi , también puede jugar con el estilo en la pestaña Diseño si desea, por ejemplo, cambiar el color y el tamaño de la fuente para los encabezados de las categorías de documentación:
Y, por supuesto, puede agregar otros módulos Divi según sea necesario para darle vida a su página de documentación. Pero eso es todo lo que necesita hacer para agregar la funcionalidad principal de documentación.
Si necesita agregar su documentación a una página sin Divi Builder, también puede usar un complemento como Widget Shortcode para poder extraer el widget de DocuPress a través de un código corto.
Terminando
Con todo, DocuPress es una solución bastante simple para crear y administrar documentación en WordPress. No espere toneladas de campanas y silbatos, pero si solo quiere algo simple y liviano, es una buena opción.
Y aunque probablemente no le llevará mucho tiempo crear algo similar para usted con tipos de publicaciones personalizadas, de esta manera no necesita ensuciarse las manos.
Como mencioné, Robert tiene planes para agregar algunos códigos abreviados incorporados, por lo que el complemento pronto debería ser aún más fácil de usar.
Ahora le toca a usted: ¿qué le parece usar algo ligero como DocuPress para su documentación o la de su cliente? ¿Prefiere este enfoque a algunos de los complementos de documentación más pesados que existen?
Imagen en miniatura del artículo por turali / shutterstock.com