> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Página de Domínio Padrão

> Define a página que o painel põe na pasta de um site novo, a que o visitante vê enquanto o cliente não envia os arquivos dele.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Modelos** >
**Página de Domínio Padrão**

![Página que um domínio novo mostra, de fábrica: uma caixa branca com Welcome e o aviso de que o domínio ainda não tem conteúdo, em inglês](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/pagina-padrao-previa.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=451b85d5c17d6f3de39dace4be9df503)

De fábrica, é a página acima, em inglês, com a palavra *Welcome*.

## Quando o painel cria a página

A tela explica: *"Cada vez que uma nova conta de usuário é criada ou um domínio é
atribuído a um diretório inexistente, esse arquivo é criado no diretório
correspondente."* Conferido:

| Situação | A página vai para a pasta? |
| - | - |
| conta nova | **sim**, na pasta `www` da conta, no minuto seguinte à criação. Medido com uma página personalizada em `index.php`: a pasta recebeu só esse arquivo, o `##user##` virou o nome da conta, e o site dela rodou o PHP |
| domínio novo numa pasta que ainda não existe, criado pelo administrador | **sim** |
| o mesmo, criado pelo cliente na área dele | **sim** |
| subdomínio numa pasta nova | **sim** |
| pasta de um domínio trocada para uma que não existe, pelo administrador ou pelo cliente | **sim** |
| domínio passado para outra conta, sem a mesma pasta lá | **sim**, e o `##user##` vira o nome da conta nova |
| domínio apontado para uma pasta que já existe | não: a pasta fica como está |
| domínios que já existiam antes de mudar a página | **não mudam**: continuam com a página antiga |

## Mudar a página

![Tela Página de Domínio Padrão: o Nome do arquivo, com index.html, e o editor de Código com o começo da página de fábrica](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/pagina-padrao.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=a77ed68d85e2f27cf63818360eae49d1)

1. Em **Nome do arquivo**, escolha **index.html** ou **index.php**.
2. Em **Código**, escreva a página.
3. Clique em **Salvar**.

O painel responde *"As configurações foram atualizadas."* A mudança vale para as
pastas criadas dali em diante.

| Campo | Vem com | O que faz |
| - | - | - |
| **Nome do arquivo** | **index.html** | o nome do arquivo criado. A tela avisa: *"Se você deseja usar o código PHP dentro da página padrão do seu domínio, você deve escolher index.php."* |
| **Código** | a página *Welcome* de fábrica | o conteúdo do arquivo |

O editor tem os atalhos que a tela lista embaixo dele: *"Busca: Crtl + F,
Substituir: Crtl + H, Tela cheia: F11, Sair da tela cheia: F11 / Esc"*.

### O `##user##`

No código, `##user##` é trocado pelo nome de usuário da conta dona do domínio.
**Medido:** uma página com `Conta: ##user##` chegou à pasta nova com o nome de
usuário da conta no lugar do `##user##`. A troca é feita quando o arquivo é
criado, então ele já fica gravado com o nome.

### Com `index.php`, o PHP roda

**Medido:** uma página `index.php` com um trecho de PHP que calcula um número
abriu no navegador com o resultado do cálculo, e não com o código.

### A página personalizada vai sozinha

A página de fábrica é formada por dois arquivos, o `index.html` e um
`bulma.min.css`, com o estilo. **Com uma página personalizada, a pasta nova
recebe só o arquivo escolhido em Nome do arquivo.** Estilo, imagem ou qualquer
outro arquivo que a página use precisa vir de fora, por endereço completo. A
outra saída são os esqueletos, explicados abaixo, e aí o esqueleto leva todos os
arquivos, a página inclusive.

> [!WARNING]
>
> **O código vazio é aceito, e o site nasce em branco**
>
> Medido: salvar com o **Código** vazio teve a resposta de sempre, *"As
> configurações foram atualizadas."*, e o domínio criado em seguida recebeu um
> `index.html` de 1 byte. O site abriu sem erro e sem conteúdo nenhum, uma página
> em branco.

## Ver a página antes

A introdução da tela tem o link **pré-visualização**, que abre numa aba nova o
arquivo gravado.

**A prévia mostra o arquivo como ele está gravado, e não como o visitante vai
ver.** Medido com uma página personalizada:

| No código | Na prévia | Na pasta do domínio |
| - | - | - |
| `##user##` | continua `##user##` | o nome da conta |
| trecho de PHP, com `index.php` | aparece `[PHP CODE]` no lugar | o PHP roda |

Para ver o resultado de verdade, é preciso criar um domínio e abri-lo.

## Voltar à página de fábrica

![Botões Voltar a visão geral, Redefinir configurações e Salvar](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/pagina-padrao-redefinir.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=fcf52b48340eaa780868633621d8f707)

O botão **Redefinir configurações** só aparece depois do primeiro **Salvar**,
**mesmo que nada tenha mudado**. Medido: salvar a página de fábrica sem mexer
gravou uma cópia inteira dela, e o painel passou a tratá-la como personalizada,
com o botão na tela. Cada gravação fica anotada no Registro de Eventos como
*"Domain default page updated."*

1. Clique em **Redefinir configurações**.
2. Na janela *"Tem certeza de que deseja redefinir as configurações?"*, clique em **Sim**.

O painel responde *"As configurações foram redefinidas."* Voltam a página de
fábrica **e o Nome do arquivo `index.html`**: conferido saindo de uma página
`index.php`. O botão some de novo.

## Vários arquivos: os esqueletos

A introdução da tela aponta para outro recurso: *"Se você deseja que vários
arquivos definíveis livremente sejam criados automaticamente no diretório
apropriado, você pode colocar seus modelos de arquivo no diretório
/etc/keyhelp/skel/."* Essa pasta fica no servidor, fora do painel, e as regras
estão no arquivo `README` dentro dela.

**Medido, com uma pasta de esqueleto de teste criada lá dentro:**

* Os formulários de criar conta e de adicionar domínio ganharam um campo novo, de escolha do esqueleto. Sem nenhuma pasta de esqueleto, o campo não aparece.
* A opção que vem escolhida é **Página padrão do domínio**, que é a página desta tela.
* **Com o esqueleto escolhido, a pasta nova recebeu só os arquivos do esqueleto, sem a página padrão.**

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Mudei a página e os sites antigos continuam com a antiga** | a página só vai para pasta nova | trocar o arquivo nas pastas antigas, pelo gerenciador de arquivos ou por FTP |
| **O site novo abre em branco** | a página foi salva com o **Código** vazio | escrever a página, ou usar **Redefinir configurações** |
| **O site novo abre sem estilo** | a página personalizada usa um arquivo de estilo que não vai junto | usar endereço completo para o estilo, ou um esqueleto com todos os arquivos |
| **O PHP aparece como texto no site** | o **Nome do arquivo** ficou em **index.html** | escolher **index.php** |
| A prévia mostra `##user##` e `[PHP CODE]` | a prévia mostra o arquivo gravado | criar um domínio de teste e abrir |
| O **Redefinir configurações** apareceu sem ninguém ter mudado a página | alguém clicou em **Salvar**, e isso já faz o painel tratar a página como personalizada | nada, se a página é a de fábrica; o Registro de Eventos diz quando foi |
| O site novo não tem a página padrão | foi escolhido um esqueleto, ou a pasta já existia | conferir o campo de esqueleto e a pasta do domínio |

## Ver também

* [Adicionar um domínio](/keyhelp-admin/adicionar-dominio), onde a pasta nova é criada
* [Adicionar um domínio (área do cliente)](/keyhelp/adicionar-dominio), o mesmo pelo cliente
* [Editar um domínio](/keyhelp-admin/editar-dominio) e [Trocar o proprietário de um domínio](/keyhelp-admin/trocar-proprietario-do-dominio), os outros dois caminhos que criam pasta nova
* [Criar uma conta de cliente](/keyhelp-admin/criar-conta-de-cliente), que também recebe a página
* [Importar/Exportar as Configurações](/keyhelp-admin/importar-exportar-as-configuracoes), que leva a página para outro servidor


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.