Instalando WebGiz
Índice
Visão Geral
O conjunto de aplicativos envolvidos no WebGiz são fundamentados na ferramenta Joomla, ou seja, o sistema WebGiz é a soma de módulos e componentes para o Joomla.
Vocabulário
- IIS : servidor de páginas html da Microsoft;
- Componentes: Aplicativos completos que utilizam o Joomla como container e são completamente independentes;
- Módulos: Pequenos aplicativos do Joomla, capaz de interagir na interface com o usuário.
- Templates: Forma do joomla de organizar os desenho da tela, exibindo os módulos e/ou componentes.
- CRM: Software gerenciador de conteúdo seja informação, interação, aplicativos, etc.
- DAO: Data Access Object ou Objeto de acesso a dados. Utilizado para concentrar toda a regra de negócio para acesso a tabelas de banco de dados.
Requisitos Mínimos para o WebGiz
- Apache 2.0
- MySQL 5.0.x
- PHP 5.2.X
Observação: Caso o cliente já tenha IIS instalado e queira integrar o pacote do WebGiz, deverá ser instalado os aplicativos PHP e MySQL separadamente e realizando as devidas modificações de integração entre IIS e PHP através de ISAPI Filter.
Alterações
PHP 5.2.X
Alterações necessárias ao arquivo php.ini:
- short_open_tag = On
- error_reporting = E_ALL & ~E_NOTICE & ~E_WARNING
- display_errors = On
- register_globals = Off
- file_uploads = On
- upload_max_filesize = 20M (tamanho máximo definido pelo cliente)
- session.save_path = “${path}/tmp“
- extension=php_gd2.dll (utilizada nos gráficos)
- extension=php_mbstring.dll (utilizada no login)
- extension=php_mcrypt.dll (utilizada no login)
- extension=php_mssql.dll (conector para MS-SQL)
- extension=php_mysql.dll (conector para MySQL)
- extension=php_xmlrpc.dll (tradutor de XML)
- extension=php_zip.dll (compactador/descompactador)
Estrutura de Diretórios
Components: Diretório com os componentes do Joomla. Nesta pasta estarão também os componentes da aix com a seguinte nomenclatura. com_aix*****
Somente as pastas com a nomenclatura acima são da AIX, as demais são do pacote do Joomla.
Html: Diretório com os arquivos html personalizáveis de boletos, contrato de matrícula e diário de classe.
Modules: Diretório com os módulos de interação com o usuário do Joomla. Nesta pasta também estão os módulos da AIX com a seguinte nomenclatura. mod_aix****
Templates: Diretório com os templates (apresentação) utilizados para o “layout” de saída.
Por padrão a pasta aix terá sempre o modelo de apresentação definido pela AIX, sendo quando necessário personalização por parte do cliente, esta pasta deverá ser duplicada e modificada. Em breve tópico relacionado a templates explicará como modificar a aplicar o template.
Installation: Diretório com os arquivos de instalação do Joomla. Aqui contem o script de criação do banco de dados MySQL necessário para funcionamento do Joomla.
Esta pasta não deverá existir uma vez que tenha instalado corretamente e criado o arquivo configuration.php, sendo assim será necessário renomeá-la ou excluí-la logo após terminar a instalação.
A última interface de instalação é o local onde os banco de dados da AIX, instituições e configurações de acesso deverão ser postados.
Arquivos de Configuração
webgiz/configuration.php
Este arquivo é de uso exclusivo do gerenciador de conteúdo Joomla. Nele são configurados acesso ao banco de dados MySQL, servidor FTP, servidor SMTP (envio de email), etc.
webgiz/components/com_aixgen/configuration.php
Este arquivo contem as configurações utilizadas pela AIX para o comportamento dos módulos e componentes do pacote;
Dentre as principais configurações, destaca-se a do banco de dados e instituições.
As demais configurações referem-se a:
- Menus
- Nomenclatura dos itens de interação com o usuário.
Módulos da Aix
webgiz/modules/
- mod_aixlogin= módulo responsável por exibir a caixa de diálogo para solicitar o usuário, senha, instituição e tipo de usuário.
- mod_aixinfologin= módulo responsável por exibir uma lista de informações do usuário ativo. Geralmente contém informações de nome, curso, período.
Administrador, Aluno, Professor, Responsável, Coordenador.
- mod_aixmenu= módulo responsável por exibir as opções de menu de acordo com as licenças e o tipo de usuário. Aqui estão as regras e formatação dos menus que foram configurados como ativos no arquivo configuration.php
Menu do administrador: 
- mod_aixmensagem= módulo responsável por exibir mensagens cadastradas para visitante ou específica para alunos e professores.
- mod_aixsurvey= módulo responsável por exibir os convites pendentes gerados pelo sistema de avaliação institucional (AIXSurvey).
Apresenta os convites específicos armazenados na tabela AVD_CONVITES.
Para que seja exibida a caixa, a licença do módulo deve existir na pasta com_aixgen/lic
webgiz/components/
- com_aixgen= De fundamental importância, este componente é responsáel por conter os arcabouços de terceiros utilizados no sistema WebGiz. Podemos destacar o ADODB, XAjax, Barcode25, dentre outros.
- Nele também encontra-se os DAO’s utilizados para obter as informações (SQL) do banco de dados do Giz. Geralmente tem o mesmo nome da entidade de banco de dados com o sufixo dao no final. Exemplo: alunodao.php
webgiz/components/com_aixgen/lic
Neste diretório devem ficar os arquivos de licença do cliente.
- com_aixaluno= componente que é responsável por todos os links relativos ao registro acadêmico.
- Nele as interfaces de notas/frequência, histórico resumido, avaliações dentre outras são processados.
- com_aixbiblioteca= componente que é responsável por todos os links relativos ao módulo de biblioteca.
- com_aixprofessor= componente com todas as funcionalidades do módulo professor.
- com_aixprotocolo= componente com todas as funcionalidades do módulo protocolo.
- com_aixrecebimentos= componente com as funcionalidades do módulo recebimentos.
- com_aixrematricula= componente responsável pela re-matrícula online e seus agregados.
Administrador do Joomla!
A função do administrador do Joomla é gerenciar o conteúdo específico dos módulos, componentes, plugins, usuários, templates.
Para entrar como administrador deve-se acessar o caminho http://localhost/webgiz/administrator
Usuário : admin
Senha: total
Para gerenciar templates, isto é, aplicar um template novo como layout do webgiz deve-se selecionar a opção Extensões | Administrar Tema
Lembre-se: O layout deve ser criado na pasta templates antes de utilizar esta opção.
Templates
Como alterar o layout com o modelo do cliente ?
A pasta “webgiz/template” contêm os possíveis templates a serem utilizados com o gerenciador de conteúdo Joomla.
Como sugestão, a pasta aix deve ser copiada para outro diretório e dentro deste diretório editar o arquivo: templateDetails.xml
Este arquivo contêm a descrição do arquivo que aparecerá na lista de templates disponíveis no Administrador de Temas do Joomla.
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//PT" "http://dev.joomla.org/xml/1.5
/template-install.dtd">
<install version="1.5" type="template">
<name>AIX</name>
<creationDate>15/07/2008</creationDate>
<author>AIX Sistemas</author>
<authorEmail>diego@aix.com.br</authorEmail>
<authorUrl>www.aix.com.br</authorUrl>
<copyright></copyright>
<license></license>
<version>1.0</version>
<description>Template AIX</description>
<positions>
<position>top</position>
<position>left</position>
</positions>
<params>
</params>
</install>
Um arquivo de template é formado por “tags” HTML e PHP;
Ainda existem tags específicas do Joomla, as quais gerenciam o local onde os módulos aparecerão e regras para aparecer ou não.
Todo o layout é formatado utilizando regras CSS para apresentar cores, formatos, posição, etc.
O arquivo CSS está dentro da pasta do template separadamente para melhor organização. (Este template foi criado pelo setor de Marketing).
Personalizando WebGiz
- Personalizando boletos bancários
Na pasta “webgiz/html/boletos” existe o arquivo boleta.htm que corresponde ao modelo padrão adotado pela AIX.
Para personalizar de acordo com o modelo do cliente, deve-se criar um arquivo boleta<codbacen>.htm com a devida formatação aceita pelo banco. Exemplo: boleta104.htm para caixa econômica.
- Personalizando contrato de matrícula
Na pasta “webgiz/html/contratomatricula” existe o arquivo default.php que corresponde ao modelo padrão adotado pela AIX.
Para personalizar de acordo com o modelo do cliente, deve-se criar um arquivo default_<curso>.php com a devida formatação. Exemplo: default_enf.php para o curso enf.
- Personalizando o diário de classe
Na pasta “webgiz/html/diarioclasse” existe uma subpasta de nome “default” que corresponde ao modelo padrão adotado pela AIX.
Nela todos os modelos de diário estão sob forma de arquivos html separados por diretórios específicos.
- Personalizando o diário de classe
Para personalizar para um curso específico, a pasta “default” deve ser copiada com o nome do curso.
Exemplo: “webgiz/html/diarioclasse/enf” e dentro desta pasta deve conter todos os arquivos da pasta default.
- Personalizando o diário de classe
Dentro de cada arquivo modelo de diário existe um conjunto de tags criadas para personalizar qual etapa deve aparecer, quantas aulas, quantas avaliações.
<configuracoes>
<numcolsdiario>70</numcolsdiario>
<numregdiario>25</numregdiario>
</configuracoes>
Regras de Negócios Básicas
Entrada (login)
Será considerado no login de usuário na caixa de seleção de tipo de usuário as regras:
- Licença do cliente
- Os arquivos de licença são conjugados para habilitar ou não um determinado tipo de usuário, por exemplo:
- Um cliente tem somente protocolo, mas aparece login de professor e aluno.
- Configuração no arquivo configuration.php da pasta com_aixgen com a entrada:
- var $tiposUsuarios = array('A', 'P', 'R', 'B', 'D');
- Sendo A = Aluno, P = Professor, R = Responsável, B = Biblioteca, D = Outros
