Agregar entradas de blog y de foros

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

El portal de servicios para desarrolladores te permite crear blogs y foros de conversación:

  • La compatibilidad con blogs permite a los usuarios crear, editar y borrar entradas de blog. Además, los permisos basados en funciones te permiten restringir las acciones del blog a tipos de usuarios específicos.
  • Los foros permiten que los usuarios creen debates en forma de conversación con moderación basada en roles. Puedes agregar foros al portal, agruparlos en una jerarquía y configurar los roles del usuario para controlar el acceso a los foros.

Cómo trabajar con blogs

El portal permite a los usuarios con los privilegios necesarios crear, editar y borrar entradas de blog. Los blogs constan de entradas individuales, que tienen marcas de tiempo y se ven por fecha. Cualquier persona, incluidos los usuarios anónimos, puede ver las entradas de blog más recientes mediante el vínculo de navegación que se proporciona en la página principal del portal.

Cualquier usuario que tenga los privilegios necesarios puede comentar una entrada de blog. Los comentarios pueden aparecer apenas se ingresan, o bien puedes configurar el portal para desarrolladores de modo que se deban moderar los comentarios antes de que aparezcan. De forma predeterminada, los usuarios anónimos no pueden publicar comentarios.

Información acerca de los tipos de blogs

El portal admite dos tipos de blog según tu versión:

  • El blog estándar, implementado por el módulo Blog de Drupal, se utiliza de forma predeterminada en las versiones del portal anteriores a la 14.02.156.1.
  • El blog personalizado de Apigee con una vista personalizada de entradas, compatibilidad con los tipos de contenido de imagen, audio y video, y una barra de herramientas de edición estilo “tumblr” como implementan los módulos personalizados de Drupal de Apigee En las versiones 14.02.156.1 y posteriores del portal, se usa el blog personalizado de Apigee de forma predeterminada. Los portales existentes se pueden actualizar para que usen el blog nuevo como parte de la actualización a la versión 14.02.156.1.

El blog personalizado se define mediante tres módulos personalizados de Drupal proporcionados por Apigee. En la siguiente tabla, se describen esos módulos:

Módulo Definición
Blog de Devconnect Define la funcionalidad básica del blog.
Menú de creación de contenido de DevOps Define el menú que te permite crear diferentes tipos de contenido de blog.
Tipos de contenido del blog de devconnect Define los tipos de contenido especial de Drupal para el blog: imagen, audio y video. Sin este módulo, solo puedes crear entradas de blog de tipo artículo.

Determina la versión del portal y los tipos de blog admitidos:

Puedes descubrir la versión del portal mediante el siguiente comando de cURL:

$ curl <portal url>/buildInfo

Si quieres usar el blog personalizado, asegúrate de que tu versión sea la 14.02.156.1 o posterior.

Actualiza un portal existente para que use los módulos de blog personalizados de Apigee:

  1. Asegúrate de que tu portal se haya actualizado a la versión 14.02.156.1 o posterior.
  2. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  3. Selecciona Modules en el menú de Drupal.
  4. Inhabilite el módulo Blog.
  5. Habilita los siguientes tres módulos personalizados de Apigee:
    • Blog de DevOps
    • Menú de creación de contenido en Devconnct
    • Tipos de contenido de blog de desconnect
  6. Guarde la configuración.

Cómo ver un blog

El portal para desarrolladores muestra las entradas recientes del blog en su página. Las entradas del blog se muestran en orden descendente según el momento de creación. Para mostrar la página Blog, selecciona Blog en el menú principal del portal para desarrolladores.

Además, el portal para desarrolladores está configurado inicialmente para mostrar entradas de blog recientes en la página principal. Las entradas también se muestran en orden descendente según el momento de creación.

Configuración de permisos para el blog

Como administrador, puedes controlar los permisos necesarios para realizar acciones en el blog, como crear, editar y borrar entradas de blog.

También configurarás los permisos necesarios para publicar, editar y borrar comentarios del blog, y si se debe moderar el comentario de un usuario. Si no es necesario moderar un comentario, aparecerá de inmediato. Si el comentario debe moderarse, un usuario del portal con el permiso necesario para moderar los comentarios deberá aprobarlo.

Para configurar permisos de blog, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Personas en el menú de Drupal.
  3. Selecciona el vínculo Permisos en la parte superior de la página Personas.
  4. Desplázate hacia abajo hasta el área de Comentarios de la página.
  5. En el área Comentarios, configura los siguientes permisos que controlan qué usuarios pueden agregar, ver, editar y aprobar comentarios:
    • Administra los comentarios y la configuración de los comentarios
    • Ver comentarios
    • Comentarios de la publicación
    • Omitir la aprobación del comentario
    • Editar comentarios propios
  6. Desplázate hacia abajo hasta el área Nodo de la página.
  7. En el área Nodo, establece cinco permisos diferentes que controlan qué usuarios pueden agregar, editar y borrar entradas de blog:
    • Entrada de blog: Crea contenido nuevo
    • Entrada de blog: Editar propio contenido
    • Entrada de blog: Edita cualquier contenido
    • Entrada de blog: Eliminar contenido propio
    • Entrada de blog: Borra cualquier contenido
  8. Guarda la configuración.

Cómo agregar una entrada de blog

Todos los usuarios con los permisos necesarios pueden crear una entrada de blog. Sin embargo, puedes configurar roles de usuario para que un usuario pueda agregar y editar su propia entrada de blog, pero no borrarla. También pueden agregar, editar y borrar sus propias entradas de blog, pero no las de otros usuarios.

Si tu versión del portal usa el módulo del blog de Drupal, aparecerá el siguiente botón que te permitirá crear una entrada de blog:

Aparecerá la página predeterminada para la edición del blog:

Si usas el blog personalizado de Apigee y habilitaste la compatibilidad con todos los tipos de contenido del blog, aparece el siguiente menú para crear entradas de blog de diferentes tipos:

Selecciona el botón del tipo de contenido apropiado para crear la nueva entrada de blog. Según el tipo de contenido seleccionado, aparece el siguiente editor:

Los botones de la parte inferior derecha te permiten agregar contenido definido por el proyecto Bootstrap, lo que incluye un carrusel, un featurette, un jumbotron y un trifold.

En el área inferior, podrás agregar el contenido multimedia asociado. Por ejemplo, en la figura anterior para el tipo de contenido de video, puedes agregar un video a la entrada del blog.

Para agregar una entrada de blog, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Blog en el menú de navegación del portal para desarrolladores.
  3. Selecciona Crear nueva entrada de blog (módulo del blog de Drupal) o el tipo de contenido (blog personalizado de Apigee).
  4. Agrega contenido en las secciones Título y Cuerpo.
  5. Si corresponde, haz clic en Editar resumen para agregar un resumen.
  6. Ingresa una lista de palabras clave separadas por comas. Estas palabras clave se usan para propagar la vista de temas actuales en la página Blog. De manera opcional, puedes agregar la vista de temas actuales a la página principal o a cualquier otra.
    Según el tipo de entrada de blog, es posible que debas expandir el área de Metaetiquetas de la página para ingresar palabras clave.
  7. Haz clic en Guardar.
    El blog se publica en la página principal del blog y aparece en la página principal del área de Entradas del blog recientes.

Cuando creas una nueva entrada de blog, el módulo Blog registra información básica sobre el contenido, como el ID del autor, la fecha de creación y el tipo de contenido.

Moderación de comentarios en blogs

Los usuarios del portal para desarrolladores pueden publicar comentarios en entradas de blog. De forma predeterminada, un usuario debe acceder al portal para publicar un comentario. La capacidad de los usuarios para ver, publicar, editar y aprobar comentarios depende de sus funciones y permisos, como se describió anteriormente.

Sigue estos pasos para moderar un comentario:

  1. Accede a tu portal como un usuario con privilegios de administrador o de aprobación de comentarios.
  2. En el menú de administración de Drupal, selecciona Contenido > Comentarios.
  3. Selecciona el vínculo Comentarios Publicados o Comentarios No aprobados.
  4. Usar esa página para moderar los comentarios

Cómo configurar la visualización de la página de blog

El portal para desarrolladores usa una vista de Drupal, denominada vista de elementos etiquetados como contenido de blog, para controlar la visualización de entradas de blog en su página. De forma predeterminada, las entradas de blog se muestran en orden descendente según la fecha de creación.

Para configurar la vista del blog, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. En el menú de administración de Drupal, selecciona Structure > Views.
  3. Selecciona el vínculo Editar en la fila de la vista Elementos etiquetados como contenido del blog (Contenido). Se mostrará la siguiente página que puedes usar para configurar la vista:

  4. Edita la vista.
  5. Guarda los cambios.

Configura la pantalla de Tema caliente para entradas de blog

El portal para desarrolladores usa una vista de Drupal, llamada Hot Topics, a fin de controlar la visualización de Hot Topics en las entradas de blog en su página. De forma predeterminada, los elementos de Temas actuales corresponden a las palabras clave que se agregaron a las entradas de blog.

Para configurar la vista Temas actuales, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. En el menú de administración de Drupal, selecciona Structure > Views.
  3. Selecciona el vínculo Editar en la fila de la vista Temas populares (contenido). Se mostrará la página que puedes usar para configurar la vista.
  4. Edita la vista.
  5. Guarda los cambios.

Cómo trabajar con foros

Los foros permiten a los usuarios que cuentan con los privilegios necesarios crear debates con una funcionalidad similar a la de otros sistemas de paneles de mensajes. Cada foro puede incluir varios temas, y cada uno de ellos puede abarcarlos. Los temas también pueden tener sus propias URLs.

Los usuarios publican temas nuevos en un foro. Cada tema del foro consta de una publicación inicial, además de respuestas o comentarios. Según los privilegios del usuario, este puede editar y borrar sus propias publicaciones, así como editar y borrar las publicaciones de otros usuarios.

De forma predeterminada, los usuarios anónimos pueden ver las publicaciones, pero no pueden publicar respuestas. Solo los usuarios autenticados que tengan los privilegios necesarios pueden responder una publicación. Las respuestas aparecen en cuanto se ingresan, lo que significa que no se moderan.

Los administradores establecen los permisos necesarios para realizar publicaciones, editar publicaciones existentes y borrarlas. Los administradores también pueden promocionar las publicaciones del foro en el área Discusiones del foro de la página principal.

Cómo determinar el módulo de Drupal que usan los foros

El portal utiliza dos módulos de Drupal para implementar foros:

  • El módulo del foro de Drupal es el módulo principal del foro y se usa de forma predeterminada en las versiones del portal anteriores a la 14.02.156.1.
  • El módulo del foro avanzado de Drupal mejora el módulo principal del foro para agregar funciones adicionales, como un estilo mejorado, una búsqueda rápida de temas activos y sin respuesta, temas nuevos y mucho más. Las versiones 14.02.156.1 y posteriores del portal usan el módulo de Foro avanzado de Drupal de forma predeterminada.

Para determinar qué módulo está activo, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Modules en el menú de Drupal.
  3. Escribe "foro" en la lista de filtros de la parte superior de la página Módulos.
    • Si el módulo Advanced Forum está en la lista y está habilitado, estás usando el módulo Advanced Forum.
    • Si el módulo Advanced Forum no está o está inhabilitado, y el módulo Forum está habilitado, estás usando el módulo principal Forum.

Como alternativa, puedes descubrir la versión del portal con el siguiente comando de cURL:

$ curl <portal url>/buildInfo

Configuración del módulo Advanced Forum

El módulo Foro avanzado tiene parámetros de configuración que controlan la visualización del foro, las rutas de navegación y otras características visuales de los foros.

Para configurar el módulo Advanced Forums, sigue estos pasos:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Configuration > Content authoring > Advanced Forum en el menú de Drupal. Aparecerá la página Advanced Forum.
  3. Configura las opciones de visualización.
  4. Guarde la configuración.

Configuración de permisos para los foros

Como administrador, controlas los permisos necesarios para realizar acciones en los foros. Estableces los permisos que usan el módulo de foros avanzados y de foros, y estableces permisos específicos para cada módulo.

Sigue estos pasos para configurar los permisos del foro:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Personas en el menú de Drupal.
  3. Selecciona el vínculo Permisos en la parte superior de la página Personas.
    • Si usas el módulo Foros avanzados, desplázate hacia abajo hasta el área Foros avanzados y establece los permisos asociados.
    • Si usas el módulo Foros, desplázate hacia abajo hasta el área Foros y establece los permisos asociados.
  4. Desplázate hacia abajo hasta el área Nodo de la página.
  5. En el área Nodo, establece cinco permisos diferentes que controlen qué usuarios pueden agregar, editar y borrar publicaciones en el foro:
    • Tema del foro: Cómo crear contenido nuevo
    • Tema del foro: Cómo editar tu propio contenido
    • Tema del foro: Cómo editar cualquier contenido
    • Tema del foro: eliminación de contenido propio
    • Tema del foro: Borrar cualquier contenido
  6. Guarda la configuración.

Agregar un foro

De forma predeterminada, el portal para desarrolladores incluye un solo foro llamado Análisis general. Puedes agregar foros adicionales o Nest Foros, y crear contenedores de foros que sean grupos de foros.

Un contenedor para foros te permite crear un conjunto de foros. Sin embargo, un contenedor no es un foro en sí mismo, solo define un conjunto de foros.

Para agregar un foro, sigue estos pasos:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Structure > Forums en el menú de Drupal para ver la lista de foros actuales.
    En esta página, puedes editar los foros existentes o cambiar el orden en que aparecen en la página Foros.
  3. Selecciona +Agregar foro.
  4. Agrega información sobre el foro nuevo, incluido su elemento superior si deseas anidarlo.
  5. Selecciona Guardar.

Para reordenar los foros, sigue estos pasos:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Structure > Forums en el menú de Drupal para ver la lista de foros actuales.
  3. Haz clic y arrastra el signo más, +, antes del nombre de un foro para cambiar su orden o nivel de anidación.
  4. Guarda los cambios.

Para agregar un contenedor del foro, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Structure > Forums en el menú de Drupal para ver la lista de foros actuales.
  3. Selecciona +Agregar contenedor.
  4. Agrega información sobre el contenedor nuevo, incluido su elemento superior si deseas anidarlo.
  5. Selecciona Guardar.
    Se abrirá la página Foros.
  6. En la página Foros, haz clic y arrastra el signo más, +, antes del nombre de un foro para agregarlo a tu contenedor nuevo.
  7. Guarda los cambios.

Promocionar un tema del foro en la página principal

La página principal predeterminada contiene una vista de Drupal que controla el contenido del área de discusión del foro de la página principal. Para que un tema del foro aparezca en el área de discusión del foro, un administrador debe promocionarlo.

Para promocionar un tema de un foro, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador o de aprobación de comentarios.
  2. En el menú de administración de Drupal, selecciona Contenido.
  3. Para filtrar el contenido, selecciona Tema del foro en el cuadro desplegable Tipo y, luego, Aplicar.
    Solo los temas del Foro aparecen en la lista de contenido.
  4. Selecciona uno o más temas del foro para promocionar.
  5. En el menú desplegable Operaciones, selecciona Promover a la página principal.
  6. Selecciona Ejecutar.
    Todos los temas seleccionados ahora aparecen en el área de discusión del foro de la página principal.

Como alternativa, puedes editar una publicación individual del foro y seleccionar Ascender a la página principal en las Opciones de publicación del tema.