= Como funciona o !ExpressoMail = 

== Código ==

 O Expresso Mail é uma aplicação/módulo constituído de PHP (servidor) + Javascript (cliente).

== Abas ==

 O objetivo de abas no !ExpressoMail é tornar a interface ágil e melhor utilização dos recursos. A figura abaixo descreve todos os tipos de abas do expressoMail:
[[Image(tiposdeabas.jpg)]] 

Figura 1

=== '''Da parte do Javascipt''': ===

'''abas.js''' : ''É reponsável pelo manuseio das abas''

Possui funções como apagar, alternar e criar aba. A figura a seguir ilustra o nome dos objetos com a respectiva demonstração visual:
[[Image(abas.png)]]
Figura 2

'''common_functions.js'''

Tem funções como:
 * adicionar caixa (input box) de arquivo anexo
 * remover caixa (input box) de arquivo anexo
 * função de lang
    As frases de lang são guardadas numa array javascript cujo índice é a chave em inglês, e o conteúdo é a frase na língua do usuário. As frases do expressoMail não são guardadas em banco.
 * busca rápida
 * inclusão de texto de encaminhamento
 * e etc...

'''main.js''' : ''Possui funções de manipulação como:''
 * criar nova mensagem (new_message)
    É chamada em toda edição de email, tanto na criação de novos como encaminhamento, resposta e edição.
 * salvar mensagem (save_msg)
    Devido a ausência de função imap implementada para editar um email, a função de salvar cria um novo email e apaga o antigo. Depois disso atualiza todas as figuras por links novos e atualiza a caixa (pasta) que está aberta no momento.
    Veja abaixo como funciona o salvamento de automático:
[[Image(rascunhos1.png)]] 
[[Image(rascunhos2.png)]] 
 * mover
 * deletar
 * salvar como (save_msg_as)
    Pede ao usuário uma caixa a qual ele deseja salvar. Não apaga o email antigo.
 * etc...

'''rich_text_editor.js''' : ''Responsável pela parte de edição de emails.''


'''draw_api.js''' : ''Possui funções de desenho do !ExpressoMail como um todo''

Dentro deste arquivo fica armazenado um estrutura global que contém informações sobre abas de todos os tipos que estão abertas.
{{{
var openTab = {
        'type' : [], // Tipo da aba de acordo com a figura 1
        'content_id' : [],
        'imapUid' : [], // UID do imap
        'countFile' : [0,0,0,0,0,0,0,0,0,0], // Num. de anexos
        'imapBox' : [], // Caixa do imap
        'toPreserve' : [] // Flag guarda se o email já foi salvo
};
var currentTab,numBox = 0; // Aba aberta e num. de abas abertas
}}}

Dentro dela fica armazenado todas as informações dos emails que estão abertos (novos ou edição). Informações como número no Imap, número de anexos e se ele deve ser apagado quando enviado. O índice do vetor é o número da aba.

'''search.js'''

Possui funções de busca.

'''connector.js'''

Este arquivo é parte fundamental do expressoMail. Ele faz toda a conexão do Javascript com o PHP, além de cache de requisições.

Funções relevantes para o programador:
 * chamada de requisições (cExecute)
 * addToCache (adiciona função a cache, é transparente ao programador)
    Para adicionar uma função PHP a lista de requisições que farão cache, o usuário deve adicionar o nome da função php no código desta função.

== Exemplo de utilização do openTab ==

No fechamento deste ticket #351, é possível exemplificar a utilização do openTab. Quando o usuário fazia uma pesquisa dos contatos pelo canto inferior esquerdo do expressoMail e acessava estes contatos uma nova mensagem era aberta. A resolução deste problema é como se segue abaixo:
{{{
  emQuickSearchUser.prototype.create_new_message = function (cn, mail){
                _this.close_window(); // Fecha a janela da pesquisa

                if (openTab.type[currentTab] != 4) // Se a aba aberta no momento não é do tipo "nova mensagem"
                {
                        Element("msg_number").value = cn+" <"+mail+">";

                        //Abre nova mensagem
                        new_message("new","null");
                }
                else
                {
                        // Escreve na aba aberta
                        Element('to_'+currentTab).innerHTML = cn+" <"+mail+">";
                }
        }
}}}