59 | | == Correções == |
60 | | [[TicketQuery(milestone$=2.4.0, type=defeito, resolution=fixed, format=table, col=resolution|summary|owner|reporter, group=component)]] |
| 63 | ==== Usando ''.htaccess'' ==== |
| 64 | A partir da versão 2.4.0 do Expresso Livre, as configurações relativas ao PHP necessárias para que o Expresso funcione foram concentradas no arquivo '''.htaccess'''. Então, é muito importante permitir que o Apache use tais configurações. Logo, para ter certeza que o Apache irá utilizar as configurações deste arquivo é necessário permitir seu acesso na configuração do virtual-host do Apache: |
| 65 | * Para !Debian/Ubuntu, edite o arquivo: ''/etc/apache2/sites-available/expresso'' |
| 66 | * Para !RedHat/Centos, edite o arquivo: ''/etc/httpd/conf.d/expresso.conf'' |
| 67 | |
| 68 | {{{ |
| 69 | <Directory /ONDE/EXPRESSO/ESTA/INSTALADO> |
| 70 | # Para o .htaccess funcionar |
| 71 | AllowOverride All |
| 72 | |
| 73 | Order allow,deny |
| 74 | allow from all |
| 75 | </Directory> |
| 76 | }}} |
| 77 | |
| 78 | ==== Novas configurações ==== |
| 79 | Na raiz do diretório principal do seu Expresso há um novo diretório, chamado '''prototype'''. Esta pasta compreende um conjunto de novas funcionalidades inseridas no Expresso, desenvolvidas sob uma nova API proposta abrangendo desde o novo módulo !ExpressoCalendar até componentes/funcionalidades de módulos já existentes como o !ExpressoMail. |
| 80 | |
| 81 | * Arquivos de configurações gerais |
| 82 | Os arquivos de configuração da pasta prototype encontram-se no diretório "/config", formando o caminho '''prototype/config'''. Neste diretório, inicialmente é necessário configurar os seguintes arquivos: |
| 83 | |
| 84 | * PostgreSQL.srv |
| 85 | {{{ |
| 86 | path = "services/PostgreSQL.php" |
| 87 | class = "PostgreSQL" |
| 88 | [config] |
| 89 | ; Conexao via socket unix |
| 90 | host = /tmp |
| 91 | ; Conexão via TCP/IP |
| 92 | ;host = 127.0.0.1 |
| 93 | port = 5432 |
| 94 | dbname = expresso |
| 95 | user = postgres |
| 96 | ; Caso o usuario tenha senha... |
| 97 | ;password= |
| 98 | }}} |
| 99 | |
| 100 | -- Neste arquivo deve ser configurado o "host", "port"(porta de conexão com o PostgreSQL), "dbname", "user" e caso seja necessário uma senha para conexão a mesma deve ser dado no campo "password"; |
| 101 | |
| 102 | * Sieve.srv |
| 103 | {{{ |
| 104 | path = "services/Sieve.php" |
| 105 | class = "Sieve" |
| 106 | [config] |
| 107 | host = 127.0.0.1 |
| 108 | port = 2000 |
| 109 | loginType = null |
| 110 | auth = true |
| 111 | debug = false |
| 112 | euser = '' |
| 113 | useTLS = false |
| 114 | options = null |
| 115 | }}} |
| 116 | |
| 117 | -- Neste arquivo deve ser configurado o "host"(onde está o serviço sieve - Ip da máquina), "port"(Porta do serviço Sieve), "loginType", "auth", "debug", "euser", "userTLS", "options"; |
| 118 | |
| 119 | * OpenLDAP.srv |
| 120 | {{{ |
| 121 | path = "services/OpenLDAP.php" |
| 122 | class = "OpenLDAP" |
| 123 | [config] |
| 124 | idAtribute = "uidNumber" |
| 125 | host = 127.0.0.1 |
| 126 | context = "dc=LDAP_DC" |
| 127 | ; Caso o LDAP requisite autenticao, configure os parametros a seguir |
| 128 | ;user = |
| 129 | ;password = |
| 130 | }}} |
| 131 | |
| 132 | -- Neste arquivo deve ser configurado o "idAtribute" (nome do campo do LDap que representa o Id unico do usuário), "host"(onde está o serviço OpenLDAP) e "context"; |
| 133 | |
| 134 | * Imap.srv |
| 135 | {{{ |
| 136 | path = services/ImapServiceAdapter.php |
| 137 | class = ImapServiceAdapter |
| 138 | }}} |
| 139 | |
| 140 | ==== Módulo REST API ==== |
| 141 | A partir da interface de instalação de módulos do expresso (expresso/setup) na tela de visualização de módulos instalados/desinstalados/desatualizados, Será necessário procurar pelo módulo com o título "REST API", marcá-lo para instalação e clicar sobre o botão salvar. Veja maiores detalhes na imagem abaixo. |
| 142 | |
| 143 | 2 - Após a instalação do módulo "REST API", procurar pelo módulo com o título "Expresso Mail", marcá-lo para atualização e clicar sobre o botão salvar. Veja maiores detalhes na imagem abaixo. A ordem de instalação destes módulos deve ser seguida desta maneira, instalando primeiro o "REST API", pois "Expresso Mail" precisará que ele já esteja instalado para que a nova funcionalidade de contatos dinâmicos funcione corretamente. |
| 144 | [[Image(setup.jpg,center,70%)]] |
| 145 | |
| 146 | |
| 147 | ==== Limite de resultados de uma pesquisa no LDAP ==== |
| 148 | |
| 149 | Em diversos locais do expresso são realizadas buscas no LDAP. Nestes locais, ao escolher um setor ou pressionar "Enter" em um campo vazio, será retornado resultados limitados do LDAP. Isto ocorre por que este valor está fixo no código, porém é possivel alterá-lo. |
| 150 | |
| 151 | Para alterar a quantidade de resultados em uma pesquisa no LDAP é preciso editar o arquivo "prototype/services/OpenLDAP.php". Procure pela variável "var $limit = 10" presente na linha 9 deste arquivo. Ao alterar o valor desta variável, o limite máximo de resultados em uma busca no LDAP será alterada. Segue abaixo uma imagem para maiores detalhes de localização. |
| 152 | [[Image(limit.jpg,center,22%)]] |
| 153 | |
| 154 | = Novas funcionalidades = |
| 155 | Abaixo será descrito como utilizar as novas funcionalidades do Expresso. |
| 156 | |
| 157 | == Nova agenda: !ExpressoCalendar == |
| 158 | A nova agenda, chamada de !ExpressoCalendar é um novo módulo, desenvolvido do ''zero'' pela Prognus em parceria com a CAIXA. O objetivo desta nova agenda é disponibilizar funcionalidades de agendamento conforme os padrões utilizados no mercado, como iCalendar, não suportados na agenda atual (!Calendar). |
| 159 | |
| 160 | === Instalação === |
| 161 | O processo de instalação do !ExpressoCalendar é simples. Seu código já está contido no pacote do Expresso Livre, a partir da versão [wiki:versoes/24 2.4.0], portanto só resta ativá-la, seguindo estes passos: |
| 162 | 1. Acesse o setup do Expresso e instale o novo módulo, como [wiki:attachment/wiki/documentacao/instalarExpresso/SetupAplicaçõesInstalandomoduloREST.png neste exemplo]; |
| 163 | 2. É obrigatório configurar os arquivos "PostgreSQL.srv", "OpenLDAP.srv", "SMTP.srv", ..., demonstrados anteriormente; |
| 164 | 3. Permita que o usuário ''expresso-admin'' possam utilizar o novo módulo, por meio da configuração no módulo Admin; |
| 165 | 4. Ativar o módulo para os usuários ou para um grupo de usuários pelo módulo !ExpressoAdmin; |
| 166 | 5. Não esqueça de configurar o '''cron''' conforme demonstrado [wiki:documentacao/atualizarExpresso#Ajustandoosnovosrequisitosdanovaversão anteriormente]. |
| 167 | |
| 168 | A partir deste ponto, a nova agenda estará disponível para uso no seu Expresso Livre! Faça bom uso! |
| 169 | |
| 170 | === Migrando os dados da agenda === |
| 171 | Caso não possa, ou não queira, perder o histórico da sua atual agenda (Calendar) do Expresso Livre, você pode fazer a migração dos dados. |
| 172 | 1 - Entrar no módulo Administrador; |
| 173 | |
| 174 | 2 - Em "expressoCalendar" clicar em "!ExpressoCalendar migração*" (Imagem 1); |
| 175 | [[Image(img1.jpg,center,45%)]] |
| 176 | |
| 177 | 3 - Clicar no botão "Salvar" uma vez (Imagem 2). O sistema ira migrar e voltar ao home do módulo Administrador; |
| 178 | [[Image(img2.jpg,center,35%)]] |
| 179 | |
| 180 | Obs.: A migração ainda não suporta Repetições e nem Alarmes, portanto não serão migrados junto com os eventos!ainda estão em 'TODO'. |
| 181 | |
| 182 | |
| 183 | == Novo auto-completar para destinatários de mensagem == |
| 184 | |
| 185 | No módulo Expresso Mail, para que a nova funcionalidade de auto-completar para destinatários de uma mensagem seja funcional, será preciso seguir os passos abaixo: |
| 186 | |
| 187 | 1- Limpar os todos os dados de cookie e cache de seu navegador. Para que a interface de remoção destes dados seja exibida em seu navegador, utilize o atalho Ctrl+Shift+del ou procure pela funcionalidade no menu de seu navegador, a imagem abaixo utiliza como exemplo a remoção de dados para o navegador firefox. |
| 188 | [[Image(limpar_cache_firefox.jpg,center,50%)]] |
| 189 | |
| 190 | 2 - Selecionar um identificador único que o usuário contenha em seu LDAP. Para isto acesse o módulo "Administrador" e acesse o link "Configuração do servidor" do módulo Expresso Mail. Ao final da página que será aberta, em "Identificador do destinatário de uma mensagem" escolha o atributo LDAP disponível no campo de seleção exibido. Para finalizar esta modificação clique sobre o botão "Salvar". A imagem abaixo utiliza como exemplo o atributo "uid". |
| 191 | [[Image(alterar_atributo_ldap.jpg,center,50%)]] |
| 192 | |