ARTIGOS

Crie o seu fórum com o Flarum

Um fórum open source feito em PHP

O [Flarum](https://flarum.org/) é um software de fórum open-source, desenvolvido abertamente no [GitHub](https://github.com/flarum/flarum) com foco na simplicidade. Você pode usar o Flarum para configurar facilmente um fórum de discussão para o seu site ou aplicação.

## Objetivos do Flarum

Destina-se a ser:  
  
- **Rápido e simples.** Sem confusão, sem inchaço, sem dependências complexas.O Flarum é construído com PHP, por isso é rápido e fácil de implantar.  A interface é alimentada por Mithril, um framework JavaScript leve e com alto desempenho.
  
- **Bonito e responsivo.**  O Flarum foi cuidadosamente projetada para ser consistente e intuitivo em todas as plataformas, pronto para uso.
  
- **Poderoso e extensível.** Personalize, estenda e integre o Flarum para se adequar à sua comunidade.  A arquitetura da Flarum é incrivelmente flexível, priorizando APIs abrangentes e ótima documentação.  
  
- **Gratuito e aberto.** O Flarum é lançado sob a [licença MIT](https://github.com/flarum/flarum/blob/master/LICENSE) .

# Instalação

### Requisitos de sistema

Para instalar o Flarum é preciso atender os requisitos mínimos:

- Servidor web: Apache (com mod_rewrite), Nginx ou Lighttpd
- PHP 5.6 ou superior com as seguintes extensões:
	- mbstring
	- json
	- gd
- MySQL 5.5 ou superior
- Composer
- Acesso SSH

Os comandos para instalar os pacotes acima são:

```r
$ sudo apt-get install apache2

$ sudo apt-get install php
$ sudo apt-get install php-mbstring
$ sudo apt-get install php-json
$ sudo apt-get install php-gd

$ sudo apt-get install mysql-server

$ sudo apt-get install composer
```

Para habilitar o módulo rewrite

```r
$ sudo a2enmod rewrite
$ service apache2 restart
```

### Instalando o Flarum

Com o composer instalado em sua máquina, execute este comando no local onde o Flarum deve ser instalado:

```r
$ composer create-project flarum/flarum . --stability=beta
```

O composer irá instalar o Flarum junto com todas as suas dependências. Depois que o composer instalar o Flarum, você precisa dar permissão de escrita na pasta em questão.

```r
$ chmod 777 flarum/ -Rf
```

### Criando o banco de dados para o Flarum

O Flarum está preparado para trabalhar com o banco de dados `mysql`, e para que a instalação seja concluída precisamos criar uma base para as informações do fórum. É recomendado que você crie um usuário e uma base específicos para o Flarum.

Você pode criar o usuário e a base diretamente pelo `phpMyAdmin` ou por linhas de comando, se você escolheu a segunda opção o primeiro passo é acessar o `mysql`

```r
$ mysql -uroot -p
```

Conectado no `mysql` você precisa criar uma base de dados e um usuário que serão usados pelo Flarum para completar a instalação.

```sql
CREATE DATABASE flarum;

CREATE USER 'flarum'@'localhost' IDENTIFIED BY 'minha_senha';

GRANT ALL PRIVILEGES ON flarum.*  TO 'flarum'@'localhost';

FLUSH PRIVILEGES;
```

### Finalizando a instalação

Se todos os passos anteriores foram executados da forma correta ao acessar `localhost/flarum` ou `seu_ip/flarum` você deve visualizar uma tela assim:

![Instalação do flarum](resources/posts/flarum/images/1.png)

Para concluir a instalação do Flarum devemos preencher o formulário final, as informações solicitadas são as seguintes:

1. Título do fórum
2. Host do banco `mysql`
3. Nome do banco de dados criado para o flarum
4. Nome do usuário com acesso ao banco de dados
5. Senha do usuário do banco de dados
6. Prefixo das tabelas (opcional)

As próximas informações serão usadas para criar o usuário administrador do fórum:

1. Nome de usuário do administrador
2. E-mail do administrador
3. Senha do administrador
4. Senha do administrador

O formulário preenchido deve ficar parecido com a imagem a seguir:

![Instalação do flarum](resources/posts/flarum/images/2.png)

Agora basta clicar em `Install Flarum` e pronto o seu fórum está criado.

## Possíveis erros

Depois de completar a instalação, ao tentar criar um novo tópico o Flarum exibia o segunte erro:

```raw
The requested resource was not found.
```

Caso tenha acontecido este erro para você, certifique-se que o `mod_rewrite` do apache está ativo. Se mesmo assim o erro persistir verifique se no arquivo `/etc/apache2/sites-enabled/000-default.conf`, contém a seguinte informação:

```js
<Directory "/var/www/html">
	AllowOverride All
</Directory>
```

[Para mais informações.](https://discuss.flarum.org/d/1869-solving-404-not-found-issues-on-apache)

# Primeiras impressões

Depois de instalar o Flarum está é a primeira tela que você verá:

![Tela inicial flarum](resources/posts/flarum/images/3.png)

Rapidamente podemos ver que o Flarum é um software bem simples e intuitivo, no entanto ele está em inglês. Embora a comunidade esteja trabalhando em traduções para vários idiomas, nenhum deles foi divulgado de maneira oficial.

## Recursos

### Interface

A interface do Flarum sem nenhuma customização é simples e muito intuitiva. Além da maneira padrão, é possível visualizar as discussões com um painel duplo, onde os tópicos ficam na esquerda enquanto as respostas ficam do lado direito:

![Painel duplo Flarum](resources/posts/flarum/images/4.png)

Para habilitar a visualização em dois painéis basta clicar no ícone de tachinha no canto superior esquerdo, fica ao lado do botão de voltar `<`.

### Carregamento infinito

As respostas de um tópico do fórum são carregadas dinamicamente, seguindo a navegação do usuário. O Flarum ainda lembra da última posição caso você volte a navegar em um determinado tópico.

### Responsivo

O Flarum é totalmente responsivo, a interface foi otimizada para funcionar perfeitamente em dispositivos móveis. Contando com botões grandes,  animações suaves e suporte a gestos.

### Suporte a extensões

O Flarum conta com varias extensões nativas, que podem ser ativadas ou desativadas, um exemplo seria a extensão de likes, que permite que usuários avaliem uma discussão. É possível ainda desenvolver as suas próprias extensões.

### Temas

O esquema de cores pode ser customizado pelo administrador do fórum, além de existir um botão para um tema escuro padrão. O Flarum foi construído usando  `Less`, um pré-processador de `CSS`. De maneira que, é possível sobrescrever variáveis para mudar diversos aspectos da interface do fórum.

![Personalização do flarum](resources/posts/flarum/images/5.png)

### Muito mais

O Flarum conta com muitos outros recursos, não tenha medo de se aventurar e descobrir todas as suas funcionalidades. Não se esqueça de acompanhar o lançamento das novas versões que sempre disponibilizam algum *feature* novo.

# Modo de administrador

Ao logar no Flarum com o usuário administrador criado na instalação, o usuário tem acesso ao painel admin onde diversas configurações podem ser feitas. O painel pode ser acessado pela url `flarum/admin#/` ou clicano no nome do usuário admin no cabeçalho da página.

![Acesso ao painel administrador](resources/posts/flarum/images/6.png)

Dentro do painel admin exitem muitas opções de configuração, como:

- Título do fórum
- Descrição do fórum
- Banner de boas-vindas
- Configuração de envio de e-mails
- Permissões
- Aparência
- Extensões

![Painel adm](resources/posts/flarum/images/7.png)

# Como configurar o envio de e-mails

Com o Flarum é possível configurar o envio de e-mails pela interface administradora. Caso você não tenha um servidor ' `SMPT` você pode usar aplicações como [mailgun](https://www.mailgun.com/) que oferece envio gratuito de e-mails, ou até mesmo usar uma conta particular do gmail.

Caso você use a opção de enviar e-mails por uma conta do gmail, é necessário  autorizar o [acesso de app menos seguro](https://myaccount.google.com/lesssecureapps). Mesmo realizando essa configuração ainda é possível que o google bloqueie o envio, nesses casos você receberá um e-mail onde será necessário uma segunda autorização,  afirmando que você tem conhecimento dos riscos.

Exemplo de uma configuração de envio de e-mails:

![Configuração de envio de e-mails](resources/posts/flarum/images/8.png)

# Conclusões

O Flarum é um software muito divertido de se usar, embora ainda esteja em uma versão beta, ele tem grande potencial. Você pode usá-lo para testes, trabalhos acadêmicos ou qualquer aplicação não oficial. Não deixe de acompanhar o desenvolvimentos pelo [site oficial](https://flarum.org/).

![Flarum](resources/posts/flarum/images/9.png)

ARTIGOS

Crie o seu fórum com o Flarum

Um fórum open source feito em PHP

COMENTE SOBRE