Documentação

Manual do Linsei

Como descarregar, instalar, configurar e usar o seu encurtador, passo a passo e secção a secção.

1. O que é o Linsei

O Linsei é um encurtador de URLs auto-alojado: instala-o no seu servidor e, a partir de um painel, cria links curtos, personaliza-os e mede cada clique. Os seus dados nunca saem do seu alojamento.

É leve (PHP com MySQL ou SQLite) e cresce consigo: vários utilizadores com papéis, estatísticas, idiomas, API e complementos.

2. Requisitos

  • PHP 8.0 ou superior com PDO.
  • MySQL/MariaDB (recomendado) ou SQLite (sem configuração).
  • Apache (com mod_rewrite) ou Nginx.
  • Acesso por FTP ou gestor de ficheiros.
Sem MySQL? Escolha SQLite no instalador: funciona sem configurar nada.

3. Descarga

  1. Clique em Descarregar Linsei (.zip).
  2. Descomprima: verá index.php e as pastas app/, assets/, plugins/ e data/.

4. Instalação

Sem consola nem comandos:

  1. Envie tudo por FTP para a pasta pública (ex. public_html).
  2. Abra o seu site: aparece o instalador.
  3. Passo 1: requisitos. Passo 2: base de dados (MySQL ou SQLite). Passo 3: administrador.
  4. O Linsei cria config.php e as tabelas sozinho.
No fim, deixe config.php só de leitura e use HTTPS.

5. Acesso ao painel

Entre em https://tudominio.com/admin com o seu utilizador e palavra-passe. Gere tudo a partir daí; para sair, use Terminar sessão.

6. O painel inicial

Ao entrar vê um resumo: total de links, cliques, cliques de hoje e links ativos, com um gráfico dos últimos dias. O botão «+ Novo link» cria um em segundos. O menu lateral leva ao resto.

7. Criar e personalizar links

Clique em «+ Novo link» e preencha:

  • URL de destino (obrigatória).
  • Código/slug: automático se vazio, ou o seu (oseudominio.com/promo).
  • Prefixos por campanha (blog-meu-link).
  • Prefixo de título para classificar.
  • Atualizar se existe: reutiliza um slug sem duplicar.

Ao guardar, copia o link curto. A lista mostra a data de criação e permite ordenar por coluna (destino, cliques, data, estado), pesquisar e selecionar vários para ações em lote: exportar, ativar, desativar ou apagar. Também pode editar, copiar ou apagar cada link.

8. Validade e limites

  • Data de expiração: deixa de redirecionar após essa data.
  • Máximo de cliques: desativa-se sozinho ao atingir o limite.

Ideal para promoções temporárias ou links de uso único.

9. Estatísticas

Cada link tem a sua página de estatísticas, com tudo o que precisa:

  • Cliques totais e por período (dia, semana, mês, ano), com cliques únicos.
  • País do visitante (a geolocalização vem de série, sem configurar nada), dispositivo, navegador e sistema operativo.
  • Fontes de tráfego (de onde chegam os cliques) e distribuição por hora e dia da semana.
  • Gráfico de evolução e comparação entre links.

O administrador vê tudo; cada gestor, o seu, com o ranking dos seus links mais visitados.

10. Utilizadores e papéis

Como administrador, em Gestores cria contas (com o seu email) e ativa ou desativa. Se um gestor esquecer a palavra-passe, pode recuperá-la por email ou o administrador pode mudá-la na hora. Dois papéis:

PapelO que pode fazer
AdministradorControlo total: todos os links e estatísticas, utilizadores, ajustes e atualizações.
GestorApenas os seus links e estatísticas.

Cada gestor trabalha isolado: várias equipas partilham a mesma instalação sem conflitos.

Ações sobre um gestor:

  • Ativar/desativar: um gestor desativado não pode entrar no painel, mas os seus links continuam a funcionar e as estatísticas mantêm-se. É reversível.
  • Alterar email de recuperação ou alterar palavra-passe: atualiza os seus dados de acesso na hora.
  • Eliminar: ao eliminar um gestor, o Linsei pergunta o que fazer com os seus links: reatribuí-los a outro gestor (os links e estatísticas mantêm-se) ou apagá-los (os seus URLs deixam de funcionar; irreversível). Se só quer bloquear o acesso, desative-o em vez de eliminar.
A recuperação por email precisa de um servidor SMTP, que configura em Ajustes.

11. Exportar para CSV

A partir da lista ou das estatísticas pode exportar para CSV (Excel e Google Sheets) para relatórios ou cópias, com filtros por datas e por gestor.

12. Idioma do painel

O painel está em 8 idiomas: espanhol, inglês, francês, português, alemão, italiano, neerlandês e polaco. Mude com o seletor do cabeçalho; a sua escolha é recordada. Em Ajustes → Idiomas ativa/desativa idiomas e carrega um novo (um .php traduzido). Também pode deixá-lo por FTP em data/lang/ (a salvo das atualizações).

13. A API

Crie links a partir de outros programas. Cada utilizador tem o seu token (no perfil). Exemplo:

curl -X POST https://tudominio.com/api/links \ -H "Authorization: Bearer TU_TOKEN" \ -H "Content-Type: application/json" \ -d '{"url":"https://ejemplo.com/pagina-larga","slug":"promo"}'

A resposta inclui o link curto. É o que a extensão de Chrome usa.

14. Complementos

O Linsei amplia-se com complementos sem tocar no núcleo. Três formas de os instalar:

  • Em Complementos no painel, instale os oficiais com um clique.
  • Clique em «Enviar complemento» para enviar o seu próprio .zip.
  • Ou copie a sua pasta para plugins/ por FTP.

Quer criar o seu? Ligam-se com hooks (ações e filtros). Há um guia completo com um exemplo.

15. Segurança

  • Palavras-passe com bcrypt e sessões nativas.
  • Proteção CSRF em todos os formulários.
  • Registo de atividade por utilizador.
  • Ficheiros do núcleo protegidos contra acesso direto.

Use sempre HTTPS e deixe config.php só de leitura.

16. Atualizar

O Linsei atualiza-se com um clique. Em Ajustes → Atualizar Linsei vê a sua versão instalada e, se houver uma nova, um botão «Atualizar para a última versão». O Linsei descarrega o núcleo, faz uma cópia de segurança e substitui apenas os ficheiros do programa.

A atualização nunca toca nos seus complementos, dados ou config.php: os seus links, estatísticas e ajustes mantêm-se, e se algo falhar restaura a cópia automaticamente.

Também pode atualizar à mão reenviando os ficheiros do pacote (sem apagar config.php nem data/), mas com o botão não é preciso.

17. Ajuda e suporte

No painel tem uma página de Ajuda (/admin/ayuda). Dúvidas ou erros? Escreva-nos a partir de contacto.