# O Catálogo de Aplicações

Source: https://support.kapsulehost.com/pt-pt/apps-overview

O catálogo de Aplicações é uma biblioteca navegável de aplicações web que pode colocar num site que já aloja com a KapsuleHost, desde WordPress e WooCommerce até wikis, análises, sincronização de ficheiros e ferramentas de automação.

## O Que É o Catálogo

As aplicações são software que corre no seu alojamento, não produtos adicionais aos quais subscreve. Já paga pelo site; uma aplicação é o que escolhe correr nele.

O catálogo existe para que não tenha de pesquisar, descarregar, descompactar e configurar esse software sozinho. A maioria das entradas tem um instalador comprovado que configura a aplicação num site que indicar, cria a sua base de dados, gera uma conta de administrador e entrega-lhe o acesso.

> **Note:** Aplicações é um item de topo na barra lateral do KPanel, no grupo **Main** entre **Websites** e **E-mail**. O endereço directo é `/apps`.

## Quanto Custam as Aplicações

Nada. As aplicações são instaladas num site pelo qual já paga, pelo que não existe custo pela aplicação em si nem nada a reembolsar. O que paga é o alojamento subjacente.

Isso tem uma consequência prática a ter em conta: uma aplicação mais pesada usa mais recursos do seu plano. Uma wiki para cinco pessoas e uma loja com muito movimento são cargas muito diferentes no mesmo plano.

![O catálogo de Aplicações no KPanel](https://support.kapsulehost.com/help/screenshots/apps-overview.8f461cb4.webp)

## Navegar e Pesquisar

A página do catálogo abre com um indicador de contagem a mostrar quantas aplicações existem actualmente no catálogo, uma caixa de pesquisa e uma linha de categorias.

- A **Pesquisa** procura correspondências no nome da aplicação, no seu slug e na sua frase descritiva. Escrever filtra todo o catálogo numa única grelha plana de resultados.
- As **categorias** filtram por tipo. São de selecção múltipla: clique em várias para alargar o filtro, clique em **All** para repor.

Sem pesquisa e sem nenhuma categoria seleccionada, a página mostra uma única aplicação em destaque num cartão largo, e as restantes agrupadas em secções de categoria com etiquetas, para que um catálogo grande se mantenha navegável.

As categorias são: CMS, eCommerce, Análises, Ficheiros, Wiki, Fóruns, Email, Automação, Headless CMS, Gestão de Projectos, CRM, DevOps, Educação, Sites Estáticos e Ferramentas.

> **Tip:** Se souber mais ou menos o que quer mas não como se chama, use as categorias em vez da pesquisa. "Wiki" e "Headless CMS" revelam opções em que a maioria das pessoas nunca pensaria pesquisar pelo nome.

## Ler um Cartão

Todos os cartões na galeria mostram o ícone da aplicação, o seu nome, uma frase descritiva de uma linha e um ou dois indicadores:

- Um **indicador de runtime**: `PHP`, `NODEJS`, `STATIC` ou `PYTHON`. Isto indica em que tecnologia a aplicação é construída e que tipo de ambiente de alojamento necessita.
- Um **indicador Community**, em aplicações cujo instalador é contribuído pela comunidade. O script de instalação está incluído mas pode precisar de alguns passos manuais para terminar a configuração.

## Ler a Página de uma Aplicação

Clique em qualquer aplicação para abrir a sua página de detalhe. Tem duas metades.

A coluna da esquerda conta a história:

- O ícone, o nome e a frase descritiva da aplicação, com indicadores para o seu runtime, a sua categoria, se **requer uma base de dados**, se é **Community**, e se é **Featured**.
- **Sobre [aplicação]**: o que o software realmente faz.
- **Resumo**: dados sobre recursos, além de ligações externas para a documentação e página inicial do próprio projecto.

Os cartões de **Resumo** podem incluir:

| Dado | O que lhe diz |
|---|---|
| Tempo de instalação | Aproximadamente quanto tempo demora a instalação |
| RAM mínima | A memória que a aplicação precisa para funcionar |
| Disco mínimo | O espaço em disco que necessita |
| Base de dados | Se uma é criada automaticamente para si |

A coluna da direita é um painel de instalação fixo com o botão **Install [aplicação]** e quaisquer notas aplicáveis a essa aplicação.

## Aplicações Instaláveis e Aplicações que Configuramos Manualmente

Todas as aplicações no catálogo podem ser encomendadas. Não há becos sem saída do tipo "brevemente". O que varia é a forma como é instalada:

- **Aplicações com instalador comprovado** são aprovisionadas automaticamente. Configura-a, confirma e acompanha uma barra de progresso.
- **Aplicações sem instalador comprovado** são instaladas manualmente pela nossa equipa. A página da aplicação indica isso mesmo: *Configurado pela nossa equipa: instalamos esta aplicação manualmente após a sua encomenda e enviamos-lhe um email quando estiver disponível.* Clica no mesmo botão na mesma, e continua a não pagar nada.

A razão para esta divisão é deliberada: correr um script de instalação não verificado num site ativo de um cliente é uma boa forma de o quebrar. Onde não podemos garantir o script, é uma pessoa que faz o trabalho.

## Aplicações Community

Uma aplicação assinalada como **Community** tem um script de instalação contribuído em vez de mantido internamente. A página da aplicação é explícita: o script de instalação está incluído e pode precisar de alguns passos manuais para terminar a configuração.

> **Warning:** Trate uma aplicação Community como "instalada, não configurada". O software estará no seu site e acessível, mas conte fazer o assistente de configuração final você mesmo, e consulte a documentação do próprio projecto para tudo o que o instalador não conseguiu fazer. Faça uma cópia de segurança antes de começar. Consulte [Fazer uma Cópia de Segurança](https://support.kapsulehost.com/pt-pt/taking-a-backup).

## Níveis de Plano Recomendados

Algumas aplicações indicam na sua página um nível de plano mínimo recomendado, e o assistente de instalação mostra um aviso de **Actualização de plano recomendada** quando o seu plano actual está abaixo desse nível.

Esse aviso é um conselho, não um bloqueio. A instalação prossegue de qualquer forma. Mas o que ele está a avisar é real: uma aplicação que exige mais memória do que o seu plano consegue oferecer confortavelmente, ou falha durante a instalação, ou funciona mal depois. Verifique o valor de **RAM mínima** na página da aplicação face ao que o seu plano fornece antes de ignorar o aviso.

## Quem Pode Instalar

Instalar requer a permissão **apps:write**, detida por Proprietários e Administradores da conta. Outras funções podem navegar em todo o catálogo e ler todas as páginas de aplicações, mas o botão de instalação está bloqueado com uma nota sobre quais as funções que podem agir.

## O Que Fazer Se Falhar

**O catálogo não carrega.** A página mostra um cartão de erro com um botão **Tentar novamente**. Trata-se de uma falha de carregamento, não de um catálogo vazio.

**"Nenhuma aplicação corresponde à sua pesquisa."** Limpe a caixa de pesquisa ou clique na categoria **All** para repor o filtro. As categorias de selecção múltipla são fáceis de deixar activadas por engano.

**Uma aplicação que esperava não está lá.** O catálogo é curado. Se algo que precisa estiver em falta, [abra um pedido de suporte](https://support.kapsulehost.com/pt-pt/opening-a-support-ticket) e pergunte: adicionar uma aplicação ao catálogo é um pedido normal, não invulgar.

**A página da aplicação mostra um erro.** Volte a **Todas as Aplicações** e tente novamente a partir do cartão. Se persistir para uma aplicação específica, reporte o slug da aplicação num pedido de suporte.

## Próximos Passos

Depois de escolher uma aplicação, [Instalar uma Aplicação no Seu Site](https://support.kapsulehost.com/pt-pt/apps-installing) explica todo o assistente passo a passo, incluindo o que acontece quando o site de destino não está vazio.

## Relacionados

- [Instalar uma Aplicação no Seu Site](https://support.kapsulehost.com/pt-pt/apps-installing)
- [Instalar o WordPress](https://support.kapsulehost.com/pt-pt/installing-wordpress)
- [Criar o Seu Primeiro Site](https://support.kapsulehost.com/pt-pt/creating-your-first-website)
