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:
- Verifique se foi feito o upgrade do portal para a versão 14.02.156.1 ou posterior.
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Modules no menu do Drupal.
- Desative o módulo Blog.
- 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
- 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:
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Pessoas no menu do Drupal.
- Selecione o link Permissões na parte superior da página "Pessoas".
- Role a tela para baixo até a área Comentário da página.
- 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
- Role para baixo até a área Nó da página.
- Na área Nó, 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
- 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:
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Blog no menu de navegação do portal do desenvolvedor.
- Selecione Criar nova entrada de blog (módulo Blog do Drupal) ou o tipo de conteúdo (blog personalizado da Apigee).
- Adicione conteúdo nas seções Título e Corpo.
- Se aplicável, clique em Editar resumo para adicionar um resumo.
- 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. - 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:
- Faça login no portal como usuário com privilégios de aprovação de administrador ou de comentários.
- Selecione Content > Comments no menu de administração do Drupal.
- Selecione o link Comentários publicados ou Comentários não aprovados.
- 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:
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Structure > Views no menu de administração do Drupal.
- 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:
- Edite a visualização.
- 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":
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Structure > Views no menu de administração do Drupal.
- 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.
- Edite a visualização.
- 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:
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Modules no menu do Drupal.
- 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":
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Configuração > Criação de conteúdo > Fórum avançado no menu Drupal. A página "Fórum avançado" será exibida.
- Defina as opções de exibição.
- 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:
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Pessoas no menu do Drupal.
- 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.
- Role para baixo até a área Nó da página.
- Na área Nó, 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
- 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:
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- 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". - Selecione +Adicionar fórum.
- Adicione informações sobre o novo fórum, incluindo o elemento pai, se você quiser aninhá-lo.
- Selecione Salvar.
Para reordenar os fóruns:
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Structure > Fóruns no menu do Drupal para conferir a lista dos fóruns atuais.
- 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.
- Salve as mudanças.
Para adicionar um contêiner do fórum:
- Faça login no portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Structure > Fóruns no menu do Drupal para conferir a lista dos fóruns atuais.
- Selecione +Adicionar contêiner.
- Adicione informações sobre o novo contêiner, incluindo o contêiner pai, se quiser aninhá-lo.
- Selecione Salvar.
A página Fóruns é aberta. - 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.
- 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:
- Faça login no portal como usuário com privilégios de aprovação de administrador ou de comentários.
- Selecione Conteúdo no menu de administração do Drupal.
- 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. - Selecione um ou mais tópicos do fórum para promover.
- No menu suspenso Operações, selecione Promover à primeira página.
- 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.