Documentación :: cBB Blockgets


Guía Rápida • Requisitos

Los requisitos básicos son:
  1. Un foro phpBB previamente instalado, cuya versión sea igual o superior a 3.2.0.
  2. El explorador debe soporar Javascript para poder usar y administrar la extensión.

Guía Rápida • Instalación

  1. Descomprima el archivo de cBB Blockgets en un directorio local (En su ordenador).
  2. Suba todos los archivos contenidos en la carpeta upload de ese archivo (manteniendo la estructura de los directorios) al directorio ext que se encuentra en el directorio raíz de su foro.
  3. Usando su explorador web, navegue hasta el Panel de Administración y entre en Personalizar >> Extensiones
  4. Busque cBB Blockgets y haga clic en la opción Habilitar.

Guía Rápida • Actualización

  1. Usando su explorador web, navegue hasta el Panel de Administración y entre en Personalizar >> Extensiones, Busque cBB Blockgets y haga clic en la opción Deshabilitar.
  2. Elimine la carpeta blockgets que está dentro del directorio /ext/canidev/ en el servidor.
  3. Descargue y descomprima el archivo de cBB Blockgets en un directorio local (En su ordenador).
  4. Suba todos los archivos contenidos dentro de la carpeta upload de ese archivo (manteniendo la estructura de los directorios) al directorio ext que se encuentra en el directorio raíz de su foro.
  5. Usando su explorador web, navegue hasta el Panel de Administración y entre en Personalizar >> Extensiones, Busque cBB Blockgets y haga clic en la opción Habilitar.

Guía Rápida • Desinstalación

  1. Usando su explorador web, navegue hasta el Panel de Administración y entre en Personalizar >> Extensiones
  2. Busque cBB Blockgets y haga clic en la opción Deshabilitar.
  3. Una vez deshabilitado, si quiere eliminarlo completamente, haga clic en Borrar datos y posteriormente elimine el directorio /ext/canidev/blockgets de su servidor.

Manejar cBB Blockgets • Preferencias

cBB Blockgets dispone de preferencias globales con las que se puede configurar el comportamiento de la extensión con respecto al foro.

Para manejar estas opciones y las demás, es necesario poseer los permisos necesarios.
El fundador del foro tendrá establecidos esos permisos al instalar la extensión y podrá establecerlo para otros grupos desde la sección "Permisos" del Panel de Administración.

Las principales opciones se encuentran en Panel de Administración >> Extensiones >> Blockgets >> Configuración General y son:

  1. Bloques dentro del foro.
    Establece como se mostrarán los bloques dentro de las páginas del foro. Esta opción prevalece sobre la configuración individual de cada página.
    1. No mostrar: No muestra bloques en ninguna página.
    2. Páginas individuales: Muestra los bloques en las páginas configuradas para ello.
    3. Páginas iguales: Se muestran los bloques del "Indice general" en todas las páginas.
  2. Comportamiendo de la página de Inicio.
    Esta opción permite establecer cual será el comportamiento de la página de Inicio (Portal). Hay 3 opciones:
    1. Página principal del dominio: Esta opción solo está disponible si el foro está dentro de alguna subcarpeta (Por ejemplo: /foro/) y si el servidor permite la reescritura de rutas. Sirve para que los usuarios, al acceder al dominio, vean el portal sin tener que entrar dentro de dicha carpeta.
      Para que esta opción funcione correctamente, tanto el directorio principal del dominio como el archivo .htaccess de este directorio (si existe) tengan permisos para que el foro pueda modificarlos.

      Realizar este proceso manualmente
      Si no desea cambiar los permisos mencionados anteriormente puede hacer el proceso manualmente.
      Para ello, debe realizar estos pasos:
      1. Copiar el archivo {carpeta base}/{directorio del foro}/ext/canidev/blockgets/index.bak a {carpeta base}/blockgets.php
      2. En el archivo copiado (blockgets.php) buscar la línea: $phpbb_root_path = (defined('PHPBB_ROOT_PATH')) ? PHPBB_ROOT_PATH : '{ROOT_PATH}'; y sustituir {ROOT_PATH} por la ruta relativa al directorio de nuestro foro. Por ejemplo, si el foro está en la carpeta foro la línea quedaría así: $phpbb_root_path = (defined('PHPBB_ROOT_PATH')) ? PHPBB_ROOT_PATH : './foro/';
      3. Copiar el archivo {carpeta base}/{directorio del foro}/ext/canidev/blockgets/htaccess.bak a {carpeta base}/.htaccess
        Si este archivo ya existe, copiar solo el contenido, sin sobreescribir el archivo completo.
      Una vez realizados estos pasos, ir a la configuración de la extensión y elegir la opción de "Pagina principal del dominio"
    2. Página principal del foro: Muestra el portal como página principal al entrar en el foro en lugar del "Índice General" que se muestra por defecto.
    3. Página secundaria del foro: El "Indice General" se mantiene como la página principal al entrar en el foro, el portal se queda como una página secundaria.
  3. Permitir colapsar los bloques.
    Esta opción muestra u oculta la opción de colapsar en los bloques, impidiendo así que los usuarios los colapsen. Esta opción prevalece sobre la configuración individual de cada bloque.
  4. Adaptar bloques automáticamente.
    Con esta opción se puede establecer si los bloques se presentarán igual independientemente de la columna en la que se encuentren, o si por el contrario, su contenido se adaptará según el tipo de columna.
  5. Mostrar barra de acceso rápido.
    Si se habilita, se mostrará una barra en la parte superior del foro que permitirá acceder rapidamente a las opciones de la página en la que se encuentre.
  6. Resetear contador de visitas.
    Con esta opcion se resetea el contador globalmente. Estableciendo el número de visitas en 0 y la fecha de inicio del contador en la fecha actual.


Cuenta además con ciertas opciones adicionales que se encuentran en Panel de Administración >> Extensiones >> Blockgets >> Configuración Adicional

  1. Redimensionado de imágenes
    Esta función se utiliza principalmente para evitar el descuadre de los bloques, ajustando el tamaño de las imágenes.
    Se puede ajustar también para redimensionar las imágenes de los mensajes del foro, siempre que dicha página haya sido activada en la configuración de las páginas.
  2. Calendario
    Desde aquí se controlan la carácterísticas del calendario, en su página personalizada (Ej: http://tuforo.com/calendar)
    Ojo: si se desactiva el calendario desde estas opciones tampoco funcionará en los bloques.
  3. Redirecciones
    Controla las páginas a las que los usuarios serán dirigidos en determinadas ocasiones.
    En esta versión se puede escoger la página cuando un usuario se identifica, cuando se desconecta y también cuando accede a una página que no existe, pudiendo escoger entre cualquier de las páginas añadidas a la extensión.

Manejar cBB Blockgets • Administrar calendario y eventos

Esta versión de cBB Blockgets incluye un calendario al que se puede acceder mediante su página personalizada (Ej: http://tuforo.com/calendar) o a través del bloque "calendario". En este calendario se le pueden añadir eventos que se mostrarán en sus respectivos días.
Para más información sobre Administrar los bloques vea Administrar Bloques.

Para añadir un nuevo evento puede hacerlo mediante el botón que aparece al pasar el ratón por encima de un día del mes.
Para añadir un nuevo evento desde el bloque de calendario, debe hacer clic en el día deseado y luego en el botón "Añadir evento".

Para editar o borrar un evento, debe hacer clic en el evento deseado. En el diálogo que aparece, a parte de mostrar el contenido de dicho evento, aparecerán los botones para editar/borrar.

Nota: Para tener acceso a las opciones del calendario debe poseer los permisos necesarios.

Manejar cBB Blockgets • Administrar Páginas

cBB Blockgets permite administrar una Página de Inicio (Portal), pero además, permite establecer también opciones para las páginas pertenecientes al foro, asi como crear páginas personalizadas (desde cero).

Todas las páginas se administran desde Panel de Administración >> Extensiones >> Blockgets >> Páginas y Bloques.
Para crear una nueva página solo se necesita hacer seleccionar que tipo de página desea crear y hacer clic en Nueva Página. En la pantalla que se muestra, se podrán establecer las opciones generales de la página.

Estas opciones son:
  1. Página activada. Activa o desactiva las funciones de la página por completo. Esta opción sobreescribe todas las demás.
  2. Alias de la página. Puede establecer un alias (letras, números y guiones) para usar en la url de esta página. Si deja este campo en blanco, se creará una página independiente y se usará el ID como alias.
  3. Título de la página. Establece el título que se mostrará en el navegador.
    En las páginas del foro se puede dejar este campo en blanco para usar el título por defecto.
  4. Grupos. Define los grupos de usuarios que podrán ver está página. Se pueden seleccionar varios grupos usando la tecla Ctrl del teclado.
  5. Filtros. Define los parámetros necesarios (GET y POST) para que la página sea cargada.
    Para más información revise Establecer filtros en las páginas.
  6. Mostrar cabecera. Permite definir si se mostrará o no la cabecera del foro en la página.
  7. Mostrar pie de página. Permite decidir si se mostrará el contenido por defecto del final de la página.
  8. Logo. Permite establece un logo diferente para la página. Si se deja en blanco se usará el logo por defecto.
  9. Tema. Permite seleccionar el aspecto que tendrá la página. Las opciones disponibles son:
    1. Definir fondo. Permite establecer un color (white, #FFFFFF) o una imagen (http://midominio.com/imagen.jpg) como fondo de la página.
    2. Definir estilo. Permite definir con que estilo (de los que están instalados en el foro) se mostrará la página.
    3. Tema personalizado. Con esta opción se pueden establecer uno o varios archivos *.css para dar estilo a la página (cada archivo se debe establecer en una línea). También se puede establecer directamente el texto CSS que se usará.
  10. Columna Izquierda. Ancho de la columna izquierda, en píxeles o porcentaje. Si se especifica 0, la columna se deshabilitará.
    El valor recomendado es 200px.
  11. Columna Derecha. Ancho de la columna derecha, en píxeles o porcentaje. Si se especifica 0, la columna se deshabilitará.
    El valor recomendado es 200px.
  12. Espacio entre bloques. Permite establecer la separación (en píxeles o porcentaje) entre los bloques.
  13. Posición del enlace. Permite definir la zona del foro en la que aparecerá un enlace a la página.
  14. Icono del enlace. Permite establecer un icono para el enlace definido en la opción anterior.

Algunas de las opciones mencionadas sólo están disponibles en un tipo específico de página, por lo que es probable que no aparezcan todas en determinados casos.

Manejar cBB Blockgets • Administrar Bloques

cBB Blockgets permite establecer infinitos bloques tanto en las páginas predefinidas como en las personalizas, que se podrán establecer en el lugar que se desee.

Cada bloque cuenta con su configuración personalizada, por lo que podrá repetir un mismo tipo de bloque pero con otras opciones dentro de la misma página.

Los bloques se administran desde Panel de Administración >> Extensiones >> Blockgets >> Páginas y Bloques.

Para añadir un nuevo bloque solo se necesita hacer clic en Añadir bloque. Se desplegará un menú con todos los bloques disponibles.
Al pasar el ratón por encima de cada bloque, podrá ver una pequeña descripción del mismo.
Para añadirlo solo tendrá que arrastrarlo a la columna que desee. En la página que se muestra al arrastralo se podrán establecer las opciones generales del bloque, así como las opciones adicionales que cada bloque pueda tener.

Las opciones generales son:
  1. Título del bloque.
    El título del bloque, que se mostrarán en la cabecera de este.
  2. Icono del bloque.
    El icono actual que tiene el bloque, si se ha definido.
  3. Grupos.
    Define que grupos podrán ver el bloque. Puede seleccionar tantos como desee usando la tecla Ctrl de su teclado.
    Con esta opción se pueden generar páginas dinámicas, con distinto contenido según el grupo en el que se encuentre el usuario que la visualiza.
  4. Bloque activado.
    Define si el bloque está o no activado. Es posible desactivar un bloque sin eliminarlo completamente, para que no sea visible pero no perder su configuración.
  5. Permitir colapsar el bloque.
    Permite decidir si los usuarios podrán ocultar el contenido de este bloque o no y su estado inicial. Esta opción se sobreescribe con la opción general Permitir colapsar bloques de la extensión.
    1. No permitido: Los usuarios no podrán colapsar el bloque.
    2. Permitido (desplegado por defecto): Los usuarios podrán colapsar el bloque. Por defecto se mostrará desplegado.
    3. Permitido (colapsado por defecto): Los usuarios podrán colapsar el bloque. Por defecto se mostrará colapsado.
  6. Aspecto del bloque.
    Esta opción permite definir un estilo diferente para cada bloque. Puede usarse el estilo por defecto, el estilo alternativo (si el estilo instalado en el foro lo permite), mostrar solo el contenido y el título, o mostrar solo el contenido.

Una vez están creados todos los bloques, desde la página de administración de bloques, se puede observar como quedarán situados y cambiar su orden y/o la columna en la que se encuentran simplemente arrastrándolos a la posición deseada.

Algunas funciones de los bloques, como son "Activar", "Desactivar" y "Eliminar", se pueden hacer de forma masiva marcando los bloques deseados.

Los bloques pueden copiarse y moverse entre las páginas. Solo es necesario marcar los bloques deseados, hacer clic en la opción "Copiar" o "Mover" y seleccionar la página de destino.
Los bloques copiados o movidos se situarán cada uno en su respectiva columna, al final de la misma.

Grupos:
Los grupos se usan para crear columnas adicionales dentro de una determinada área. Se pueden añadir en la parte superior, central e inferior.
Dentro de estos grupos se pueden arrastrar tantos bloques como se deseen, aunque, como máximo, tendrán tres columnas. Esto quiere decir que si se añaden 3 o menos bloques a un grupo el número de columnas se ajustará al número de bloques. Sin embargo, si se añaden más de 3 bloques se ajustará a 3 columnas y los bloques sobrantes se irán situando en filas adicionales.

Para añadir un grupo solo debe arrastrar el botón al área deseada.

Manejar cBB Blockgets • Establecer filtros en las páginas

Los filtros sirven para tener un control absoluto sobre las páginas y decidir en que entornos o situaciones se cargará su contenido. Estos filtros se configuran a través de los parámetros que una página obtiene en el momento de su carga. Existen dos clases de parámetros:
  1. GET: Estos parámetros están definidos directamente en la URL de la página.
  2. POST: Estos parámetros son establecidos a través de un formulario desde otra página.

Veamos un ejemplo.
Supongamos que queremos poner un bloque en la página de login de los usuarios. La página de login utiliza el archivo "ucp.php" por lo que, si creamos una página sobre este archivo, el bloque aparecerá en el login, pero también en todas las páginas que utilicen el archivo "ucp.php" (Panel de Control de Usuario, Registro, etc..)
Para evitar esto y cargar el bloque sólo en el login utilizaremos los filtros.

La página de login de un foro phpBB3es similar a esta: http://midominio.com/foro/ucp.php?mode=login Se consideran "parámetros" todo el contenido situado después de "?" (en este caso mode=login) y son estos parámetros los que usaremos para los filtros.
Si a la hora de crear la página establecemos un filtro de tipo GET con el contenido "mode=login" haremos posible que todos los bloques de esa página se carguen solo en la página de login.

Hay tres formas de establecer un filtro:
  1. Completo: Define la variable y el valor que debe tener. Ejemplo, filtro GET "mode=login"

    http://midominio.com/foro/ucp.php?mode=login (se carga)
    http://midominio.com/foro/ucp.php?mode=otromodo (no se carga)
    http://midominio.com/foro/ucp.php (no se carga)
  2. Simple: Define solo si una variable existe, ignorando su valor. Ejemplo, filtro GET "mode"

    http://midominio.com/foro/ucp.php?mode=login (se carga)
    http://midominio.com/foro/ucp.php?mode=otromodo (se carga)
    http://midominio.com/foro/ucp.php (no se carga)
  3. Negado: Se define sólo la variable, precedida de "!". Con esto se consigue justo lo contrario, que la página se cargue cuando la variable no está presente. Ejemplo, filtro GET "!mode"

    http://midominio.com/foro/ucp.php?mode=login (no se carga)
    http://midominio.com/foro/ucp.php?mode=otromodo (no se carga)
    http://midominio.com/foro/ucp.php (se carga)
Esto funciona tanto para los parámetros GET como con los POST y se pueden combinar múltiples filtros para una misma página. Por ejemplo:
Si queremos mostrar un bloque en la página de registro, pero nó en la página de aceptación de los términos de uso, deberemos utilizar un filtro POST combinado con un filtro GET.

Tomemos como URL: http://midominio.com/foro/ucp.php?mode=register
Lo primero que aparecen son los términos de uso (en donde no queremos que aparezca nuestro bloque) y una vez aceptados nos lleva a la página de registro.
Ese formulario proporciona el parametro "agreed" una vez se aceptan los términos y es ese parámetro el que usaremos.
En nuestra página utilizaremos un filtro GET (mode=register) combinado con el filtro POST (agreed) obligando así a la página a cargarse sólo cuando ambos parámetros estén presentes.
cron