Guía Rápida • Requisitos

cBB Follower necesita muy pocos requisitos para funcionar correctamente.

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 • Compatibilidad

Por norma general, en un foro no se pueden tener instaladas dos extensiones que hagan una misma función, pues se provocarán errores entre ellas.
cBB Follower incluye, entre otras, la función de mencionar usuarios. Por lo tanto, no será compatible con las siguientes extensiones:

1. Simple Mentions
2. BBmention

Guía Rápida • Instalación

1. Descomprima el archivo de cBB Follower 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.
   La ruta final para los archivos de la extensión debe ser: /ext/canidev/follower/
3. Usando su explorador web, navegue hasta el Panel de Administración y entre en Personalizar >> Extensiones
4. Busque cBB Follower y haga clic en la opción Habilitar.

Guía Rápida • Desinstalación

cBB Follower se puede desinstalar en pocos pasos:

1. Usando su explorador web, navegue hasta el Panel de Administración y entre en Personalizar >> Extensiones
2. Busque cBB Follower 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/chat de su servidor.

Funciones Principales • Perfil de usuario

El seguidor de usuarios aporta un perfil donde se puede ver la actividad del usuario y su información más relevante.

Cada usuario puede acceder a su perfil desde el enlace situado en la barra de navegación superior.
Nota: Si se establece el perfil del seguidor de usuarios como perfil predeterminado, solo se necesitará hacer clic en los nombres de los usuarios.

Las secciones que se muestran en el perfil son:

1. Cronología: Muestra la actividad más reciente de todos los usuarios a los que se sigue.
   Esta pestaña solo se muestra en el perfil propio de cada usuario.
2. Muro: En esta pestaña se muestran los comentarios publicados por el usuario.
   Esta pestaña solo se muestra si los comentarios están activados.
3. Menciones: Esta pestaña muestra todos los comentarios y mensajes en los que el usuario ha sido mencionado.
4. Mensajes: Aquí se pueden ver los mensajes publicados y aprobados del usuario.
5. Temas: Muestra una lista con los temas creados por el usuario.
6. Siguiendo: Lista de usuarios a los cuales está siguiendo el usuario mostrado.
7. Seguidores: Lista con todos los usuarios que siguen al usuario mostrado.

Dependiendo de la sección en la que se encuentre y de los permisos que tenga adjudicados, cada usuario visualizará diferentes opciones en las listas:
Algunas de las principales opciones son: Borrar comentario, responder a un comentario, compartir comentario, responder a un tema, seguir a un usuario, etc...

Funciones Principales • Comentarios

Si esta opción está activada en el Panel de Administración y el usuario cuenta con los permisos necesarios podrá publicar comentarios breves (al estilo de twitter) en su muro.

Los comentarios se pueden publicar desde cualquier perfil usando el boton situado en la parte superior del mismo.

Funciones Principales • Menciones

Las menciones son referencias a los usuarios, similares a las menciones de Twitter, que se pueden añadir tanto en los comentarios como en los mensajes del foro.
Para las menciones se usará el símbolo @ seguido del nombre de usuario, o utilizando el bbcode "mention". Ejemplo: [mention]username[/mention] Gracias a la lista inteligente que aparece cuando se está escribiendo, mencionar a otros usuarios se hace de forma rápida y sencilla.

Funciones Principales • Hashtags (etiquetas)

Los hashtags son etiquetas que se pueden usar tanto en los comentarios como en los mensajes del foro.
Al igual que en twitter, se usa el símbolo # seguido de la etiqueta.

La extensión posee un buscador propio que permite buscar una etiqueta y mostrar todos los comentarios y mensajes que posean esa etiqueta.
En el perfil de usuario se mostrará una lista de Tendencias con las etiquetas más usadas.

Funciones Principales • Seguimiento de usuarios

Esta función permite a un usuario seguir y tener constancia a tiempo real (mediante las notificaciones) de toda la actividad de otro usuario.

Entre la actividad que se puede seguir están:

1. Los comentarios publicados.
2. Temas creados.
3. Mensajes publicados.
4. Menciones.

Funciones Principales • Configuración

Cada usuario puede personalizar determinadas características de la extensión a su gusto.

Estas opciones se encuentran en su Panel de Control de Usuario:

1. Acerca de mi:
   Ubicación: Perfil del usuario.
   Pequeño texto que cada usuario puede usar como descripción de si mismo. Este texto aparecerá en su perfil y como información adicional en las listas.
2. Imagen de perfil:
   Ubicación: Perfil del usuario.
   Imagen que se mostrará como fondo de la cabecera de su perfil.
3. Notificaciones:
   Ubicación: Preferencias de foros > Opciones de Notificación.
   En este apartado se añade la configuración de las notificaciones de la extensión.

Administrar • Opciones Generales

Accediendo a la ruta Panel de Administración >> Extensiones >> Seguidor de Usuarios podrá administrar todas las opciones de la extensión.

Las opciones disponibles en esta versión son:

1. Configuración Principal
   1. Establecer como perfil por defecto: Activando esta opción se conseguirá que el perfil de seguimiento del usuario se convierta en su perfil por defecto, ocultando el perfil predeterminado de phpBB.
      Si se habilita, la información del perfil predeterminado de phpBB aparecerán en el perfil de seguimiento.
   2. Mostrar cuadro flotante de información: Determina en que circunstancias se mostrará un cuadro flotante con información del usuario al pasar el ratón por encima de su nombre.
   3. Filas máximas: Establece las filas de elementos que se mostrarán en el perfil de seguimiento.
   4. Redimensionar imágenes: Si se habilita, las imágenes subidas serán redimensionadas al tamaño máximo especificado para los adjuntos del foro.
   5. Activar comentarios entre usuarios: Esta opcion habilita o deshabilita los comentarios para todos los usuarios.
   6. Información avanzada en los comentarios: Define si se permitirán incluir imágenes en los comentarios del muro.
   7. Caracteres máximos: Establece el límite de caracteres permitidos en los comentarios.
   8. Guardar comentarios de usuarios: Si se escoje un periodo de tiempo, los comentarios publicados fuera de ese periodo serán eliminados automáticamente de forma progresiva.
2. Herramientas Contiene herramientas para solventar errores de sincronización en los datos.

Administrar • Permisos

Para un control total sobre la extensión, se incluyen varios permisos para usuarios y moderadores.
Estos permisos se pueden establecer manualmente desde la opción Permisos avanzados que se encuentra al establecer permisos para usuarios o grupos.

Permisos de Usuarios:

1. Puede seguir usuarios. Define si un usuario puede seguir la actividad de otros usuarios del foro.
2. Puede compartir y puntuar comentarios y mensajes. Define si un usuario puede compartir y dar "me gusta" a los comentarios o mensajes del foro.
3. Puede editar/borrar los comentarios de su muro. Define si un usuario puede editor o borrar sus propios comentarios.
4. Puede mencionar usuarios. Define si un usuario puede hacer menciones de otros usuarios.
5. Puede publicar comentarios en su muro. Define si un usuario tiene activado el muro de su perfil y puede publicar comentarios en él.

Permisos de Moderación:

1. Puede editar/borrar los comentarios de los usuarios. Define si un usuario puede editar o borrar comentarios, independientemente de quien sea su autor.

Nota: Para poder administrar las opciones principales de la extensión no se requieren permisos de Administración Adicionales.

Eventos • Core

follower.acp_config_before

• Añadido en versión: 2.0.0
• Ubicación: controller/admin_controller.php
• Argumentos: display_vars, submit, cfg_array, error

follower.acp_config_after

• Añadido en versión: 2.0.0
• Ubicación: controller/admin_controller.php
• Argumentos: display_vars, submit, cfg_array

follower.acp_tools_after

• Añadido en versión: 2.0.0
• Ubicación: controller/admin_controller.php
• Argumentos: action, error

follower.profile_page_modify

• Añadido en versión: 2.0.0
• Ubicación: controller/main_controller.php
• Argumentos: mode, wall_row, user_cache, track_cache_ids, is_ajax

follower.after_ajax_run

• Añadido en versión: 2.0.0
• Ubicación: libraries/ajax.php
• Argumentos: action, template_filename, json

follower.setup

• Añadido en versión: 2.0.0
• Ubicación: libraries/follower.php
• Argumentos: active, service_options

follower.parse_before_submit

• Añadido en versión: 2.0.0
• Ubicación: libraries/follower.php
• Argumentos: text

follower.after_store_mentions

• Añadido en versión: 2.0.0
• Ubicación: libraries/follower.php
• Argumentos: type, item_id, data

follower.after_store_hashtags

• Añadido en versión: 2.0.0
• Ubicación: libraries/follower.php
• Argumentos: type, item_id, data

follower.display

• Añadido en versión: 2.0.0
• Ubicación: libraries/follower.php
• Argumentos: finder

follower.modify_row

• Añadido en versión: 2.0.0
• Ubicación: libraries/tools.php
• Argumentos: row, wall_row

Eventos • Javascript

follower.onInit

• Añadido en versión: 2.0.0
• Argumentos: service

follower.onBindButtons

• Añadido en versión: 2.0.0
• Argumentos: object (service, parentDom)

follower.onBindRows

• Añadido en versión: 2.0.0
• Argumentos: object (service, parentDom)

follower.beforeSend

• Añadido en versión: 2.0.0
• Argumentos: event (action, service, sendData)

follower.beforeDispatchEvent

• Añadido en versión: 2.0.0
• Argumentos: event (action, service, originalEvent)

Eventos • Plantillas

follower_acp_tools_after

• Añadido en versión: 2.0.0
• Ubicación: adm/style/acp_follower.html

follower_acp_body_after

• Añadido en versión: 2.0.0
• Ubicación: adm/style/acp_follower.html

follower_right_side_before

• Añadido en versión: 2.0.0
• Ubicación: styles/*/template/right_side_body.html

follower_right_side_after

• Añadido en versión: 2.0.0
• Ubicación: styles/*/template/right_side_body.html