Initial commit

README.md

@@ -0,0 +1,68 @@
+# Sistema de Ramais Telefônicos
+
+Plugin WordPress para gerenciar e exibir ramais telefônicos com busca, filtros e paginação.
+
+## Funcionalidades
+- Exibição de lista de ramais com filtros por Secretaria, Setor e busca por texto
+- Paginação dos resultados
+- Adição de novos ramais via painel administrativo
+- Armazenamento dos dados em arquivo CSV
+- Shortcode para exibição em páginas ou posts
+- Interface responsiva e amigável
+
+## Instalação
+1. Faça upload da pasta `ramais-telefonicos` para o diretório `wp-content/plugins/` do seu WordPress.
+2. Certifique-se de que o arquivo de dados `bancodados.csv` está localizado em:
+
+   ```
+   wp-content/uploads/ramais-telefonicos/bancodados.csv
+   ```
+   > O plugin cria automaticamente o diretório e o arquivo na primeira ativação, se não existirem.
+
+3. Ative o plugin no painel do WordPress.
+
+## Uso
+### Shortcode
+Adicione o shortcode abaixo em qualquer página ou post para exibir a lista de ramais:
+
+```
+[lista_ramais]
+```
+
+Você pode definir o número de ramais por página:
+
+```
+[lista_ramais per_page="10"]
+```
+
+### Painel Administrativo
+- Acesse o menu **Ramais** no painel do WordPress para adicionar novos ramais.
+
+## Estrutura dos Dados
+O arquivo `bancodados.csv` deve conter as seguintes colunas:
+
+- ramal
+- responsavel
+- secretaria
+- setor
+- email
+
+O plugin gerencia automaticamente a leitura e escrita neste arquivo.
+
+## Localização do Arquivo CSV
+O arquivo de dados deve estar em:
+
+```
+wp-content/uploads/ramais-telefonicos/bancodados.csv
+```
+
+## Dependências
+- WordPress 5.0 ou superior
+- PHP 7.2 ou superior
+
+## Créditos
+Desenvolvido por Marco Antonio Vivas.
+
+---
+
+Para dúvidas ou sugestões, abra uma issue ou entre em contato.