selfoss

selfoss 2.20-SNAPSHOT

selfoss é um leitor RSS multifuncional e aplicativo da web de agregação de feeds. Ele permite que você acompanhe facilmente as atualizações de diferentes sites, redes sociais e outras plataformas, tudo em um único lugar. Ele é escrito em PHP, permitindo que você execute-o basicamente em qualquer lugar.

Para mais informações visite nosso site.

Status

selfoss é atualmente mantido por Jan Tojnar em seu tempo livre. Devido à capacidade limitada, a manutenção é priorizada em detrimento de novos recursos. Solicitações pull são bem-vindas, consulte o guia de contribuição.

Download

• Versões estáveis ​​– se você quiser apenas usar o selfoss.
• Compilações de desenvolvimento – se você quiser experimentar recursos não lançados ou correções de bugs, ou ajudar a testá-los. Hospedado por Cloudsmith
• Código-fonte rastreado pelo Git – se você deseja ingressar no desenvolvimento do selfoss. É necessária alguma montagem.

Instalação

1. Faça upload de todos os arquivos deste diretório (IMPORTANTE: carregue também os arquivos .htaccess invisíveis).
2. Torne os diretórios data/cache , data/favicons , data/logs , data/thumbnails e data/sqlite graváveis.
3. Insira os dados de acesso ao banco de dados em config.ini (veja abaixo). Você não precisa alterar nada se quiser usar o SQLite.
4. Você não precisa criar as tabelas do banco de dados, elas serão criadas automaticamente (certifique-se de que o usuário do seu banco de dados tenha permissão para criar gatilhos).
5. Crie um cronjob ou um timer systemd para atualizar feeds e aponte-o para https://yourselfossurl.com/update via wget ou curl. Você também pode executar o cliupdate.php na linha de comando.

Se você obteve o selfoss usando Git, mais algumas etapas serão necessárias. Veja a seção de desenvolvimento.

Para mais dúvidas ou qualquer problema utilize nosso fórum de suporte: https://forum.selfoss.aditu.de/

Configuração

Nenhuma configuração é necessária para usar o selfoss, mas você pode personalizar as configurações da seguinte maneira:

1. Renomeie config-example.ini para config.ini .
2. Edite config.ini e exclua todas as linhas que você não deseja substituir.
3. Veja https://selfoss.aditu.de/ para exemplos.

Atualizar

1. Faça backup do seu banco de dados e do seu diretório data/ .
2. (IMPORTANTE: NÃO exclua o diretório data/ ) exclua todos os arquivos e diretórios antigos, excluindo o diretório data/ e o arquivo config.ini
3. Carregue todos os novos arquivos e diretórios, excluindo o diretório data/ (IMPORTANTE: carregue também os arquivos .htaccess invisíveis).
4. Consulte o arquivo NEWS para saber mais sobre alterações incompatíveis com versões anteriores.
5. Limpe o cache do seu navegador.
6. Insira sua conexão de banco de dados atual e sua configuração individual em config.ini . Importante: alteramos o config.ini e adicionamos novas opções nas versões mais recentes. Você também precisa atualizar o config.ini .
7. O banco de dados será atualizado automaticamente (certifique-se de que o usuário do seu banco de dados tenha permissão para criar gatilhos).

Se você obteve o selfoss usando Git, mais algumas etapas podem ser necessárias. Veja a seção de desenvolvimento.

Para mais dúvidas ou qualquer problema utilize nosso fórum de suporte: https://selfoss.aditu.de/forum

Apoiar

• Rastreador de problemas para relatar problemas e solicitar novos recursos
• Fórum para perguntas gerais sobre uso
• Converse no Gitter (ou no espelho #selfoss:matrix.org ) para discutir o desenvolvimento do selfoss ou qualquer coisa

Importação OPML

Selfoss oferece suporte à importação de arquivos OPML. Encontre a exportação OPML no aplicativo antigo, geralmente localizada em algum lugar nas configurações. Então visite a página https://yourselfossurl.com/opml e faça o upload lá.

Aplicativos de terceiros

Recomendamos Reader For Selfoss para dispositivos Android.

Desenvolvimento

Selfoss usa compositor e npm para instalar bibliotecas externas. Ao clonar o repositório, você deve emitir composer install para recuperar as fontes externas.

Para o lado do cliente, você também precisará de dependências JavaScript instaladas chamando npm install no diretório client/ . Você pode usar npm run install-dependencies como um atalho para instalar ambos os conjuntos de dependências.

Usamos Parcel (instalado pelo comando acima) para construir o lado cliente do selfoss. Cada vez que algo no diretório client/ for alterado, você precisará executar npm run build para que o cliente seja compilado e instalado no diretório public . Ao desenvolver, você também pode usar npm run dev ; ele observará alterações de ativos, reconstruirá os pacotes conforme necessário e recarregará o selfoss automaticamente. Ao alternar entre npm run dev e npm run build , pode ser necessário excluir client/.cache .

Se você deseja criar um pacote com todas as dependências agrupadas, você pode executar o comando npm run dist para produzir um zipball.

Espera-se que cada patch siga nosso estilo de codificação, que é verificado automaticamente pelo CI. Você pode instalar os verificadores localmente usando npm run install-dependencies e, em seguida, executar as verificações usando npm run check antes de enviar uma solicitação pull. Há também npm run fix , que tentará corrigir a formatação.

Créditos

selfoss foi criado por Tobias Zeising, e o código-fonte está licenciado sob a licença GNU General Public versão 3, ou (a seu critério) qualquer versão posterior.

Algumas partes do código-fonte podem ser licenciadas apenas na versão 3. No momento, estamos tentando resolver isso.

O pacote com dependências agrupadas pode ser distribuído apenas na versão 3.

Agradecimentos muito especiais a todos os contribuidores de pull requests aqui no GitHub, bem como aos tradutores do Weblate. Suas melhorias são incríveis!

Agradecimentos especiais aos grandes programadores dessas bibliotecas utilizadas pelo selfoss:

• Estrutura PHP sem gordura
• Torta Simples
• Imagem ampla
• htmLawed
• Gerador de feed universal PHP
• Elphin IcoFileLoader
• Graby
• Filtros FullTextRSS
• mais uma lightbox de reação

Ícone feito por http://blackbooze.com/

A hospedagem do repositório de pacotes é gentilmente fornecida pela Cloudsmith. Cloudsmith é a única solução de gerenciamento de pacotes universal totalmente hospedada, nativa da nuvem, que permite que sua organização crie, armazene e compartilhe pacotes em qualquer formato, em qualquer lugar, com total confiança.