Esta é a documentação do Apigee Edge.
Acesse
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 ao Blog, os usuários podem criar, editar e excluir postagens de blog. Além disso, as permissões baseadas em função permitem que você restrinja as ações do blog a tipos de usuários específicos.
- Os fóruns permitem que os usuários criem discussões com conversas agrupadas com moderação baseada em funções. É possível adicionar fóruns ao portal, agrupar fóruns em uma hierarquia e configurar funções do usuário para controlam 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 blogs. Blogs (links em inglês) são compostas por postagens individuais, que têm o carimbo de data/hora e são visualizadas por data. Qualquer pessoa, incluindo usuários anônimos podem visualizar as entradas mais recentes do blog usando o link de navegação fornecido em 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 à medida que são inseridos. Também é possível configurar o portal do desenvolvedor para que os comentários sejam moderados. antes de aparecerem. Por padrão, usuários anônimos não podem postar comentários.
Sobre os tipos de blog
O portal oferece suporte a dois tipos de blog, dependendo da sua versão:
- Usamos o blog padrão implementado pelo módulo Drupal Blog (em inglês). por padrão nas versões do portal anteriores à versão 14.02.156.1.
- O blog personalizado da Apigee com visualização personalizada de postagens, suporte para imagem, áudio e vídeo tipos de conteúdo e um "estilo tumblr" barra de ferramentas de edição conforme implementado pelo Apigee Drupal personalizado módulos. As versões 14.02.156.1 e posteriores do portal usam o blog personalizado da Apigee por padrão. Os portais existentes podem ser atualizados 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. O seguinte 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 do DevConnct | Define o menu que permite criar diferentes tipos de conteúdo de blog. |
| tipos de conteúdo para blog do devconnect | Define os tipos de conteúdo especiais do Drupal para o blog: imagem, áudio e vídeo. Sem neste módulo, só será 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
Para 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 o portal foi atualizado para a versão 14.02.156.1 ou mais recente.
- Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Modules no menu Drupal.
- Desative o módulo Blog.
- Ative os três módulos personalizados da Apigee a seguir:
- Blog do Devconnect
- Devconnct Menu de criação de conteúdo
- Tipos de conteúdo do blog do devconnect
- Salve a configuração.
Visualizar um blog
O portal para desenvolvedores mostra as postagens recentes na página do blog. As postagens do blog são exibidos em ordem decrescente por horário de criação. Para exibir a página do blog, selecione Blog na menu principal do portal do desenvolvedor.
Além disso, o portal do desenvolvedor é configurado inicialmente para exibir postagens recentes do blog na página inicial página. As entradas também são exibidas em ordem decrescente por horário de criação.
Definindo permissões para o blog
Como administrador, você controla as permissões necessárias para realizar ações no blog, como como criar, editar e excluir postagens de blog.
Você também configura 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 precisa ser moderado, ele aparece imediatamente. Se o comentário precisar ser moderado, um usuário do portal com as permissões necessárias permissão para moderar comentários deve aprová-la.
Para definir as permissões do blog:
- Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione People no menu Drupal.
- Selecione o link Permissões na parte superior da página "Pessoas".
- Role para baixo até a área Comentário da página.
- Na área Comentários, defina as seguintes permissões que controlam quais
os usuários podem adicionar, visualizar, editar e aprovar comentários:
- Administrar comentários e configurações de comentários
- Ver comentários
- Comentários na postagem
- Pular a aprovação do comentário
- Editar seus 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
os usuários podem adicionar, editar e excluir postagens do blog:
- Entrada do blog: crie novo conteúdo
- Entrada do blog: Editar o próprio conteúdo
- Entrada do blog: edite qualquer conteúdo
- Entrada do blog: Excluir o próprio conteúdo
- Entrada do blog: exclua qualquer conteúdo
- Salve sua configuração.
Adicionar um blog entrada
Todos os usuários com as permissões necessárias podem criar uma entrada de blog. No entanto, é possível configurar funções de usuário de modo que um usuário possa adicionar e editar sua própria entrada de blog, mas não excluí-la. Ou eles podem adicionar, editar e excluir suas próprias entradas no blog, mas não editar as entradas de outros usuários.
Se sua versão do portal usa o módulo Drupal Blog, o botão a seguir aparece para permitir você cria uma entrada para o blog:
A página de edição de blog padrão é exibida:
Se você estiver usando o blog personalizado da Apigee e tiver ativado o suporte para todos os tipos de conteúdo de blog, o menu a seguir é exibido para permitir que você crie entradas de blog de diferentes tipos:
Selecione o botão do tipo de conteúdo apropriado para criar a nova entrada do blog. Dependendo o tipo de conteúdo selecionado, o seguinte editor será exibido:
Os botões no canto inferior direito permitem adicionar conteúdo definido pelo projeto Bootstrap, incluindo um carrossel. featurette, jumbotron e trifold.
A área inferior permite adicionar a mídia associada. Por exemplo, na figura acima dos você poderá adicionar um vídeo à entrada do blog.
Para adicionar uma postagem ao blog:
- Faça login no seu 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 de blog Drupal) ou o tipo de conteúdo (blog personalizado da Apigee).
- Adicione conteúdo às 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 os
Visualização de tópicos na página do blog. Também é possível adicionar a visualização "Temas principais" à página inicial ou
a qualquer outra página.
Dependendo do tipo de entrada no Blog, talvez seja necessário expandir as Metatags da página para inserir palavras-chave. - Clique em Salvar.
O blog é publicado na primeira página do blog e é listado na Página inicial na seção Área de postagens do blog.
Quando você cria uma nova entrada no blog, o módulo Blog 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, um usuário precisa ser fez login no portal para postar um comentário. Um usuário pode ver, postar, editar e aprovar. depende da função e das permissões, conforme descrito acima.
Para moderar um comentário:
- Faça login no portal como um usuário com privilégios de aprovação de administrador ou de comentários.
- Selecione Conteúdo > Comentários no menu de administração do Drupal.
- Selecione o link Comentários publicados ou o Link de comentários não aprovados.
- Use essa página para moderar comentários.
Como configurar a exibição do blog página
O portal do desenvolvedor usa uma visualização Drupal, chamada de Itens marcados como conteúdo do blog , para controlar a exibição das entradas do blog na página do blog. Por padrão, as postagens do blog estão listados em ordem decrescente de data de criação.
Para configurar a visualização do blog:
- Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Estrutura > Visualizações no menu de administração do Drupal.
- Selecione o link Editar na linha de Itens marcados como blog
visualização de conteúdo (Conteúdo). Isso exibe a página a seguir,
que pode ser usada para configurar a visualização:
- Edite a visualização.
- Salve as alterações.
Como configurar o tópico principal exibir para entradas do blog
O portal do desenvolvedor usa uma visualização Drupal, chamada Hot Topics, para controlar o Exibição do Tópico principal para entradas do blog na página do blog. Por padrão, os itens de tópicos populares correspondem a das palavras-chave adicionadas às postagens do blog.
Para configurar a visualização "Temas principais":
- Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Estrutura > Visualizações no menu de administração do Drupal.
- Selecione o link Editar na linha dos Principais temas (Conteúdo). Isso exibe a página que pode ser usada para configurar a visualização.
- Edite a visualização.
- Salve as alterações.
Trabalhar com fóruns
Nos fóruns, os usuários com os privilégios necessários podem criar discussões em sequência com funcionalidade semelhantes a outros sistemas de quadros de mensagens. Um tópico está contido em um fórum, e cada fórum pode contêm muitos tópicos. Os tópicos também podem ter os 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 respostas ou comentários. Dependendo dos privilégios do usuário, ele pode editar e excluir os próprios privilégios e editar e excluir as postagens de outros usuários.
Por padrão, usuários anônimos podem ver postagens, mas não podem postar respostas. Apenas 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 moderados.
Os administradores definem as permissões necessárias para postar, editar postagens existentes e excluir postagens. Os administradores também podem promover postagens de fóruns para a área de Discussões do fórum da página inicial página.
Determinação do Drupal módulo usado pelos fóruns
O portal usa dois módulos Drupal para implementar fóruns:
- O Drupal Fórum: é o módulo principal do fórum e é usado por padrão pelas versões do do portal anterior para a versão 14.02.156.1.
- O Drupal Advanced Fórum: aprimora o módulo principal do fórum para adicionar outros recursos, como estilo aprimorado, pesquisa rápida de tópicos ativos, não respondidos, novos tópicos e muito mais. A versão 14.02.156.1 e mais recentes do portal usam o módulo Drupal Advance Forum por padrão.
Para determinar qual módulo está ativo:
- Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Modules no menu Drupal.
- Digite "fórum" na lista de filtros no topo da página Módulos.
- Se o módulo Advanced Forum estiver listado e ativado, você usando o módulo Advanced Forum.
- Se o módulo Avançado estiver ausente ou desativado, e o Fórum está ativado, você está usando o Fórum.
Outra opção é descobrir a versão do portal usando o seguinte comando cURL:
$ curl <portal url>/buildInfo
Como configurar o fórum avançado módulo
O módulo avançado do fórum tem configurações que controlam a exibição do fórum, a navegação estrutural, e outras características visuais dos fóruns.
Para configurar o módulo Fóruns avançados:
- Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Configuração > Autoria de conteúdo > de nível Avançado na 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ê define as permissões usadas pelo módulo Fóruns e Fóruns avançados e as permissões específicas para cada módulo.
Para definir as permissões do fórum:
- Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione People no menu 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 seção Fóruns avançados e defina as permissões associadas.
- Se você estiver usando o módulo Fóruns, role para baixo até a seção 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 quais
os usuários podem adicionar, editar e excluir postagens de fóruns:
- Tópico do fórum: Criar novo 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 qualquer conteúdo
- Salve sua configuração.
Como adicionar um fórum
Por padrão, o portal do desenvolvedor vem com um único fórum chamado Discussão geral. Você pode adicionar fóruns adicionais, aninhar fóruns e criar contêineres de fóruns, que são grupos de fóruns.
Um contêiner de fórum oferece uma maneira de criar uma coleção de fóruns. No entanto, um contêiner não é um fórum em si, ele simplesmente define uma coleção de fóruns.
Para adicionar um fórum:
- Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Estrutura > Fóruns no menu Drupal para ver a lista de fóruns atuais
fóruns.
Nesta página, você pode editar fóruns existentes ou reorganizar a ordem em que os fóruns aparecem no Fóruns. - Selecione +Adicionar fórum.
- Adicione informações sobre o novo fórum, incluindo as informações principais, se você quiser aninhar o .
- Selecione Salvar.
Para reordenar os fóruns:
- Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Estrutura > Fóruns no menu Drupal para ver a lista de fóruns atuais fóruns.
- Clique e arraste o sinal de adição + antes do nome de um fórum para alterar a ordem dele. ou de aninhamento.
- Salve as alterações.
Para adicionar um contêiner de fórum:
- Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
- Selecione Estrutura > Fóruns no menu Drupal para ver a lista de fóruns atuais fóruns.
- Selecione +Adicionar contêiner.
- Adicione informações sobre o novo contêiner, incluindo o pai, se você 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 alterações.
Promover um tópico do fórum para a página inicial página
A página inicial padrão contém uma visualização Drupal que controla o conteúdo do fórum Área de discussões da página inicial. Para que um tópico do fórum apareça nas Discussões do fórum um administrador precisa promover o tópico.
Para promover um tópico do fórum:
- Faça login no portal como um usuário com privilégios de aprovação de administrador ou de comentários.
- Selecione Content no menu de administração do Drupal.
- Filtre o conteúdo selecionando Tópico do fórum no campo Tipo
caixa suspensa e selecionando 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 para frente .
- Selecione Executar.
Todos os tópicos selecionados agora aparecem na área Discussões do fórum da página inicial.
Como alternativa, você pode editar uma postagem de fórum individual e selecionar Promover para a frente página nas Opções de publicação do tópico.