Adicionar postagens do blog e do fórum

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

O portal de serviços para desenvolvedores permite criar blogs e fóruns com conversas agrupadas:

  • Com o suporte para blog, os usuários podem criar, editar e excluir postagens de blog. Além disso, as permissões com base em papéis permitem restringir ações do blog a tipos de usuário específicos.
  • Os fóruns permitem que os usuários criem conversas agrupadas com moderação baseada em papéis. É possível adicionar fóruns ao portal, agrupar fóruns em uma hierarquia e configurar papéis do usuário para controlar o acesso aos fóruns.

Como trabalhar com blogs

No portal, os usuários com os privilégios necessários podem criar, editar e excluir postagens de blog. Os blogs são compostos de postagens individuais, que têm um carimbo de data/hora e são visualizadas por data. Qualquer pessoa, incluindo usuários anônimos, pode acessar as entradas mais recentes do blog usando o link de navegação fornecido na página inicial do portal.

Qualquer usuário com o privilégio necessário pode comentar em uma postagem do blog. Os comentários podem aparecer assim que são inseridos, ou você pode configurar o portal do desenvolvedor para que os comentários precisem ser moderados antes de aparecerem. Por padrão, usuários anônimos não podem postar comentários.

Sobre os tipos de blog

O portal é compatível com dois tipos de blog, dependendo da sua versão:

  • O blog padrão implementado pelo módulo Drupal Blog é usado por padrão pelas versões do portal anteriores à versão 14.02.156.1.
  • O blog personalizado da Apigee com uma visualização personalizada de postagens, suporte para os tipos de conteúdo de imagem, áudio e vídeo e uma barra de ferramentas de edição no estilo tumblr, conforme implementada pelos módulos personalizados do Apigee Drupal. As versões 14.02.156.1 e mais recentes do portal usam o blog personalizado da Apigee por padrão. É possível fazer upgrade dos portais existentes para usar o novo blog como parte do upgrade para a versão 14.02.156.1.

O blog personalizado é definido por três módulos Drupal personalizados fornecidos pela Apigee. A tabela a seguir descreve esses módulos:

Módulo Definição
Blog do Devconnect Define a funcionalidade básica do blog.
Menu de criação de conteúdo no Devconnct Define o menu que permite criar diferentes tipos de conteúdo do blog.
tipos de conteúdo do blog devconnect Define os tipos de conteúdo especial do Drupal para o blog: imagem, áudio e vídeo. Sem esse módulo, só é possível criar entradas de blog do tipo "artigo".

Como determinar a versão do portal e os tipos de blog compatíveis:

Você pode descobrir a versão do portal usando o seguinte comando cURL:

$ curl <portal url>/buildInfo

Se você quiser usar o blog personalizado, verifique se sua versão é 14.02.156.1 ou posterior.

Como fazer upgrade de um portal atual para usar os módulos de blog personalizados da Apigee:

  1. Verifique se foi feito o upgrade do portal para a versão 14.02.156.1 ou posterior.
  2. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  3. Selecione Modules no menu do Drupal.
  4. Desative o módulo Blog.
  5. Ative os três módulos personalizados da Apigee a seguir:
    • Blog do Devconnect
    • Menu de criação de conteúdo do Devconnct
    • Tipos de conteúdo do blog Devconnect
  6. Salve a configuração.

Visualizar um blog

O portal do desenvolvedor exibe as postagens recentes na página "Blog". As entradas do blog são exibidas em ordem decrescente por horário de criação. Para exibir a página de blog, selecione "Blog" no menu principal do portal do desenvolvedor.

Além disso, o portal do desenvolvedor é configurado inicialmente para exibir postagens de blog recentes na página inicial. As entradas também são exibidas em ordem decrescente por hora de criação.

Como configurar permissões para o blog

Por ser administrador, você controla as permissões necessárias para realizar ações no blog, como criação, edição e exclusão de postagens.

Também é possível configurar as permissões necessárias para postar, editar e excluir comentários do blog e se o comentário de um usuário precisa ser moderado. Se um comentário não precisar ser moderado, ele será exibido imediatamente. Se o comentário precisar ser moderado, um usuário do portal com a permissão necessária para moderar comentários precisará aprová-lo.

Para definir as permissões do blog:

  1. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Pessoas no menu do Drupal.
  3. Selecione o link Permissões na parte superior da página "Pessoas".
  4. Role a tela para baixo até a área Comentário da página.
  5. Na área Comentário, defina as seguintes permissões que controlam os usuários que podem adicionar, ver, editar e aprovar comentários:
    • Administrar comentários e configurações de comentários
    • Ver comentários
    • Comentários na postagem
    • Pular aprovação do comentário
    • Editar os próprios comentários
  6. Role para baixo até a área da página.
  7. Na área , defina cinco permissões diferentes que controlam quais usuários podem adicionar, editar e excluir postagens do blog:
    • Postagem do blog: crie conteúdo
    • Postagem do blog: editar seu próprio conteúdo
    • Postagem do blog: editar qualquer conteúdo
    • Postagem do blog: excluir seu próprio conteúdo
    • Postagem do blog: excluir qualquer conteúdo
  8. Salve a configuração.

Como adicionar uma entrada de blog

Todos os usuários com as permissões necessárias podem criar uma entrada de blog. No entanto, é possível configurar papéis do usuário de modo que ele possa adicionar e editar a própria entrada de blog, mas não excluí-la. Eles também podem adicionar, editar e excluir as próprias entradas do blog, mas não editar as entradas do blog de outros usuários.

Se sua versão do portal usar o módulo do blog do Drupal, o botão a seguir será exibido para você criar uma entrada no blog:

A página de edição padrão do blog será exibida:

Se você estiver usando o blog personalizado da Apigee e tiver ativado o suporte a todos os tipos de conteúdo de blog, o menu a seguir será exibido para criar entradas de blog de diferentes tipos:

Selecione o botão para o tipo de conteúdo apropriado e crie a nova entrada de blog. Dependendo do tipo de conteúdo selecionado, o editor a seguir será exibido:

Os botões no canto inferior direito permitem adicionar conteúdo definido pelo projeto Bootstrap, incluindo um carrossel, featurette, jumbotron e triplo.

A área inferior permite adicionar a mídia associada. Por exemplo, na figura acima, para o tipo de conteúdo de vídeo, é possível adicionar um vídeo à entrada do blog.

Para adicionar uma entrada de blog:

  1. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Blog no menu de navegação do portal do desenvolvedor.
  3. Selecione Criar nova entrada de blog (módulo Blog do Drupal) ou o tipo de conteúdo (blog personalizado da Apigee).
  4. Adicione conteúdo nas seções Título e Corpo.
  5. Se aplicável, clique em Editar resumo para adicionar um resumo.
  6. Insira uma lista de palavras-chave separadas por vírgulas. Essas palavras-chave são usadas para preencher a visualização da seção "Principais temas" na página do blog. Você também pode adicionar a visualização "Principais temas" à página inicial ou a qualquer outra página.
    Dependendo do tipo de entrada do blog, talvez seja necessário expandir a área Metatags da página para inserir palavras-chave.
  7. Clique em Salvar.
    O blog é publicado na primeira página do blog e aparece na página "Início" da área "Postagens recentes".

Quando você cria uma nova entrada no blog, esse módulo registra informações básicas sobre o conteúdo, incluindo o ID do autor, a data de criação e o tipo de conteúdo.

Moderação de comentários no blog

Os usuários do portal do desenvolvedor podem postar comentários nas entradas do blog. Por padrão, o usuário precisa estar conectado no portal para postar um comentário. A capacidade dos usuários de ver, postar, editar e aprovar comentários depende da função e das permissões, conforme descrito acima.

Para moderar um comentário:

  1. Faça login no portal como usuário com privilégios de aprovação de administrador ou de comentários.
  2. Selecione Content > Comments no menu de administração do Drupal.
  3. Selecione o link Comentários publicados ou Comentários não aprovados.
  4. Use essa página para moderar comentários.

Como configurar a exibição da página do blog

O portal do desenvolvedor usa uma visualização do Drupal, chamada Itens marcados como visualização de conteúdo do blog, para controlar a exibição das entradas do blog na página "Blog". Por padrão, as entradas de blog são listadas em ordem decrescente de data de criação.

Para configurar a visualização do blog:

  1. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Structure > Views no menu de administração do Drupal.
  3. Selecione o link Editar na linha da visualização Itens marcados como conteúdo do blog (Conteúdo). Isso exibe a seguinte página, que pode ser usada para configurar a visualização:

  4. Edite a visualização.
  5. Salve as mudanças.

Como configurar a exibição dos temas mais acessados para entradas do blog

O portal do desenvolvedor usa uma visualização do Drupal, chamada Principais temas, para controlar a exibição dos temas em alta nas entradas do blog na página "Blog". Por padrão, os itens de Temas interessantes correspondem às palavras-chave adicionadas às postagens do blog.

Para configurar a visualização "Temas interessantes":

  1. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Structure > Views no menu de administração do Drupal.
  3. Selecione o link Editar na linha da visualização Temas principais (conteúdo). Isso exibe a página que você pode usar para configurar a visualização.
  4. Edite a visualização.
  5. Salve as mudanças.

Como trabalhar com fóruns

Os fóruns permitem que os usuários com os privilégios necessários criem discussões agrupadas com funcionalidade semelhante à de outros sistemas de quadros de mensagens. Um tópico é incluído em um fórum, e cada fórum pode conter vários tópicos. Os tópicos também podem ter seus próprios URLs.

Os usuários postam novos tópicos em um fórum. Cada tópico do fórum é composto por uma postagem inicial, além de respostas ou comentários. Dependendo dos privilégios do usuário, ele pode editar e excluir as próprias postagens, além de editar e excluir as postagens de outros usuários.

Por padrão, os usuários anônimos podem visualizar as postagens, mas não postar respostas. Somente usuários autenticados com o privilégio necessário podem responder a uma postagem. As respostas aparecem assim que são inseridas, o que significa que não são moderadas.

Os administradores definem as permissões necessárias para publicar, editar e excluir postagens. Os administradores também podem promover postagens na área "Discussões" da página inicial.

Determinar o módulo Drupal usado pelos fóruns

O portal usa dois módulos Drupal para implementar fóruns:

  • O módulo Drupal Forum é o módulo principal do fórum e é usado por padrão por versões do portal anteriores à versão 14.02.156.1.
  • O módulo Drupal Advanced Forum (em inglês) aprimora o módulo principal do fórum para adicionar outros recursos, incluindo estilo aprimorado, pesquisa rápida para temas ativos, assuntos não respondidos, novos tópicos e muito mais. As versões 14.02.156.1 e mais recentes do portal usam o módulo do fórum Drupal Advance por padrão.

Para determinar qual módulo está ativo:

  1. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Modules no menu do Drupal.
  3. Insira "forum" na lista de filtros na parte superior da página "Módulos".
    • Se o módulo Advanced Forum estiver listado e ativado, você está usando o módulo Advanced Forum.
    • Se o módulo Advanced Forum estiver ausente ou desativado e o módulo Forum estiver ativado, você está usando o módulo principal do Forum.

Você também pode descobrir a versão do portal usando o seguinte comando cURL:

$ curl <portal url>/buildInfo

Como configurar o módulo do fórum avançado

O módulo "Fórum avançado" tem definições de configuração que controlam a exibição do fórum, a localização atual e outras características visuais dos fóruns.

Para configurar o módulo "Fóruns avançados":

  1. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Configuração > Criação de conteúdo > Fórum avançado no menu Drupal. A página "Fórum avançado" será exibida.
  3. Defina as opções de exibição.
  4. Salve a configuração.

Definição de permissões para os fóruns

Como administrador, você controla as permissões necessárias para realizar ações nos fóruns. Você configura permissões usadas pelos módulos avançados e fóruns, além de permissões específicas para cada módulo.

Para definir as permissões do fórum:

  1. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Pessoas no menu do Drupal.
  3. Selecione o link Permissões na parte superior da página "Pessoas".
    • Se você estiver usando o módulo Fóruns avançados, role para baixo até a área Fóruns avançados e defina as permissões associadas.
    • Se você estiver usando o módulo Forums, role para baixo até a área Fóruns e defina as permissões associadas.
  4. Role para baixo até a área da página.
  5. Na área , defina cinco permissões diferentes que controlam os usuários que podem adicionar, editar e excluir postagens do fórum:
    • Tópico do fórum: Criar conteúdo
    • Tópico do fórum: Editar o próprio conteúdo
    • Tópico do fórum: Editar qualquer conteúdo
    • Tópico do fórum: Excluir o próprio conteúdo
    • Tópico do fórum: Excluir conteúdo
  6. Salve a configuração.

Como adicionar um fórum

Por padrão, o portal do desenvolvedor vem com um único fórum chamado Discussão geral. É possível adicionar outros fóruns, aninhar fóruns e criar contêineres de fóruns, que são grupos de fóruns.

Com um contêiner de fórum, você pode criar uma coleção de fóruns. No entanto, um contêiner não é um fórum em si, apenas define uma coleção de fóruns.

Para adicionar um fórum:

  1. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Structure > Fóruns no menu do Drupal para conferir a lista dos fóruns atuais.
    Nesta página, você pode editar os fóruns atuais ou reorganizar a ordem em que eles aparecem na página "Fóruns".
  3. Selecione +Adicionar fórum.
  4. Adicione informações sobre o novo fórum, incluindo o elemento pai, se você quiser aninhá-lo.
  5. Selecione Salvar.

Para reordenar os fóruns:

  1. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Structure > Fóruns no menu do Drupal para conferir a lista dos fóruns atuais.
  3. Clique e arraste o sinal de adição, +, antes do nome de um fórum para alterar a ordem ou o nível de aninhamento.
  4. Salve as mudanças.

Para adicionar um contêiner do fórum:

  1. Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Structure > Fóruns no menu do Drupal para conferir a lista dos fóruns atuais.
  3. Selecione +Adicionar contêiner.
  4. Adicione informações sobre o novo contêiner, incluindo o contêiner pai, se quiser aninhá-lo.
  5. Selecione Salvar.
    A página Fóruns é aberta.
  6. Na página Fóruns, clique e arraste o sinal de adição, +, antes do nome de um fórum para adicioná-lo ao novo contêiner.
  7. Salve as mudanças.

Promover um tópico do fórum na página inicial

A página inicial padrão contém uma visualização Drupal que controla o conteúdo da área de discussões do fórum da página inicial. Para que um tópico do fórum apareça na área "Discussões do fórum", um administrador precisa promover o tópico.

Para promover um tema do fórum:

  1. Faça login no portal como usuário com privilégios de aprovação de administrador ou de comentários.
  2. Selecione Conteúdo no menu de administração do Drupal.
  3. Para filtrar o conteúdo, selecione Tópico do fórum na caixa suspensa Tipo e depois Aplicar.
    Somente tópicos do fórum aparecem na lista de conteúdo.
  4. Selecione um ou mais tópicos do fórum para promover.
  5. No menu suspenso Operações, selecione Promover à primeira página.
  6. Selecione Executar.
    Todos os tópicos selecionados aparecem na área "Discussões do fórum" na página inicial.

Você também pode editar uma postagem individual do fórum e selecionar Promover na página inicial nas Opções de publicação do tópico.