Convertir Joomla en una página de documentación con Phoca Documentation

box-pdcTutorial para convertir Joomla en una página de documentación con Phoca Documentation. Este componente nos permitirá modificar la forma en que Joomla muestra los artículos y las categorías, transformando nuestra web en una página de documentación.

Podemos descargar el componente desde su página oficial e instalarlo siguiendo los pasos habituales.

Durante el proceso de instalación, tras pulsar en “Subir e Instalar”, tendremos la opción de actualizar el componente (si tenemos instalada una versión anterior) o realizar una nueva instalación, borrando así los datos de versiones previas.

phoca_documentation_200_1

 

Una vez instalado, podemos acceder al componente desde “Componentes > Phoca Documentation”. Aquí veremos un acceso a la información del componente y otro acceso al gestor de categorías de Joomla. Además podremos comprobar si existe una versión mas reciente del componente pulsando en “Check for Update”.

 

phoca_documentation_200_2

 

Si pulsamos en “Categories”, accederemos al gestor de categorías de Joomla, donde podremos administrar o borrar las categorías existentes y crear otras nuevas.

 

phoca_documentation_200_3

 

Para que el contenido de nuestra web se muestre como si de una página de documentación se tratase, tendremos que ir al gestor de menús y crear un nuevo elemento del tipo “List of Categories”.

 

phoca_documentation_200_4

Tras esto, será suficiente con completar los datos comunes de los menús (título, alias, acceso, etc)

phoca_documentation_200_5

Si accedemos al front-end y pulsamos sobre el menú que acabamos de crear, veremos una lista encabezada por las categorías principales de nuestro sitio, seguidas de sus categorías anidadas.

 

phoca_documentation_200_6

 

Si pulsamos en cualquiera de las categorías que aquí aparecen, accederemos a una lista con el contenido de las mismas (categorías y artículos).

phoca_documetation_200_7

 

Existe la posibilidad de sustituir la lista de subcategorías por una descripción de la categoría principal. Para ello, vamos a “Componentes > Phoca Documentation” y pulsamos en “Options”. Aquí, cambiaremos la opción “Display Main Category Description” a “yes”. También podremos agregar una descripción general para las categorías, ajustar algunas opciones de visualización, y ocultar o mostrar las categorías que queramos.

phoca_documentation_200_8

 

El resultado de sustituir las categorías anidadas por la descripción es similar a este:

phoca_documetation_200_9

 

Además del tipo de menú descrito anteriormente, podemos crear otro del tipo “List of Articles in Category”, que mostrará una lista de las categorías y de los artículos existentes en una categoría .

phoca_documetation_200_11

 

Después de completar los datos propios de lo menús, en “Required Settings” tendremos que seleccionar la categoría cuyos artículos queremos mostrar.

phoca_documentation_200_12

 

El resultado del front-end será similar a este:

phoca_documentation_200_13

 

Ordenando las categorías

A pesar de que el componente “Phoca Documentation” no cuenta con ninguna opción que nos permita ordenar las listas de categorías de forma alfabética, podemos cambiar este parámetro con una pequeña modificación en el código. Para ello, tendremos que ir al directorio raíz de Joomla y en “componentes/com_phocadocumentation/models” editar los archivos “categories.php” y “category.php”.

phoca_documetation_200_14

 

El primero de ellos, “categories.php”, nos permitirá modificar el orden de las categorías principales. Lo abrimos con un editor de texto y vamos a la línea 197 donde tendremos que cambiar el “1” por el “3”.

phoca_documentation_200_15

 

Editando el segundo archivo, “category.php”, podremos cambiar el orden de las categorías anidadas (línea 197) y el de la lista de artículos (línea 184), realizando el mismo cambio que en el archivo anterior, el “1” por el “3”.

phoca_documentation_200_16

 

Una vez hechos los mencionados cambios, tanto la lista de categorías como la de artículos aparecerán ordenadas alfabéticamente.

phoca_documetation_200_17

 

Phoca Documentación Navigation Plugin

Este plugin, complementa al componente “Phoca Documentation”. Con él podremos añadir varios botones que nos permitirán navegar por los artículos de la misma categoría.

Podemos descargar el plugin desde la página de Phoca e instalarlo de la manera habitual.

Una vez activado, tendremos que añadir el código a aquellos artículos en los que queremos que aparezcan los botones de navegación. Para ello, nos dirigimos al gestor de artículos y copiamos el siguiente código en la parte superior del artículo:

phoca_documentation_200_18

 

Después de guardar los cambios, en el front-end veremos que aparecen tres botones en el artículo (retroceder, tabla de contenidos, avanzar).

 

phoca_documentation_200_19

 

También podemos agregar un segundo código en la parte inferior del artículo:

phoca_documentation_200_20

 

De esta forma, incluiremos un botón que nos llevará a la parte superior del artículo.

phoca_documetation_200_21

 

El código de este plugin acepta diversos parámetros que nos permitirán agregar o quitar botones y que están detallados en la página de documentación de Phoca.

 

Enlace | Phoca Documetation

Enlace | Phoca Documentation Navigation Plugin

Escribir un comentario

Por favor procura que tus comentarios estén relacionados con la entrada, comenta con tu nombre y no pongas enlaces en tu comentario. Intenta también respetar a los demás lectores, los comentarios off topic, promocionales, ofensivos o ilegales serán editados y borrados.


Código de seguridad
Refescar