Manual de administração do educommons

Transcrição

1 Manual de administração do educommons

2 Índice 1. Instalação do educommons 1.1. Pré-Requisitos 1.2. Pacotes necessários 1.3. Instalação do Python 1.4. Instalação do pacote Imaging para Python 1.5. Instalação do PyXML 1.6. Instalação do mxtidy 1.7. Instalação do Zope 1.8. Criação de uma instância do Zope 1.9. Instalação de produtos do Zope 2. Configuração do educommons 2.1. Adicionar/Excluir produtos 2.2. Personalizar a aparência do educommons 2.3. Registro de erro 2.4. Configuração de idioma 2.5. Configuração de Configuração de Busca 2.7. Preferências do site 2.8. Administração de Usuários e Grupos 2.9. Interface de administração do zope Preferências do site Configurações de licenças Metadados Template de Categorias Tradução Sindicalização de conteúdos Configuração do FCKeditor Eliminação do alta de usuário (cadastro) Alterar a imagem corporativa que aparece nas categorias e cursos Incluir novidades e avisos na página principal 3. Administração de categorias e cursos 3.1. Adicionar um curso novo 3.2. Importar o template do curso 4. Criação de grupos 2

3 3

4 1. Instalação do educommons 1.1. Pré-Requisitos O educommons funciona em ambientes Linux. O COSL (The Center for Open and Suitable Learning) recomenda a instalação em Red Hat. Na UPM, a instalação foi testada no Fedora e também no Debian, sem grandes problemas no momento da instalação. É recomendável dispor de um servidor dedicado exclusivamente para o OCW. O servidor de aplicativos utilizado será o Zope. A seguir, são detalhados todos os pacotes necessários e sua instalação passo a passo; 1.2. Pacotes necessários Todos os pacotes necessários podem ser baixados a partir do portal do OCW Universia em na seção de downloads da área privada. É importante obter os pacotes nesse site, pois muitos deles contêm modificações em relação aos originais, como traduções, alterações, correções, etc. - Python tar.gz - Zope final.tar.gz - Pacotes específicos para o Python o Imaging tar.gz o PyXML tar.gz o egenix-mx-base tar.gz o egenix-mx-experimental tar.gz o Librería zlib.so - Pacotes para o Zope o Plone-2.5-universia.tar.gz o FCKeditorPlone_2.2.1.tar.gz - Pacotes para o educommons o educommons universia.tar.gz o educommons patch1.tar.gz Instalação Será usado o diretório/opt, portanto os comandos farão referência a esse diretório. Caso queira trabalhar em outro diretório, será necessário levar isso em consideração no momento de executar os comandos. O diretório /opt/instalables será usado como diretório base, onde serão disponibilizados todos os pacotes. Na instalação presumiremos que foi iniciada uma sessão e o trabalho está sendo feito como root. 4

5 1.3. Instalação do Python Descompactar e instalar o Python: ~# tar zxvf /opt/instalables/python tar.gz ~# cd Python ~#./configure ~# make ~# make install copiar o arquivo zlib.so na pasta /usr/local/lib/python2.4/lib-dynload ~# mv /opt/instalables/zlib.so /usr/local/lib/python2.4/lib-dynload 1.4. Instalação do pacote Imaging para Python Descompactar e instalar: ~# tar zxvf /opt/instalables/imaging tar.gz ~# cd Imaging ~# /usr/local/bin/python/ setup.py build ~# /usr/local/bin/python/ setup.py install 1.5. Instalação do PyXML Descompactar e instalar: ~# tar zxvf /opt/instalables/pyxml tar.gz ~# cd PyXML ~# /usr/local/bin/python/ setup.py build ~# /usr/local/bin/python/ setup.py install 1.6. Instalação do mxtidy (Opcional. Insere correção e validação de erros XTML) O pacote mxtidy é usado para fazer validações XHTML em todos os documentos HTML do educommons, portanto é altamente recomendável instalar esses pacotes. Descompactar e instalar: ~# tar zxvf /opt/instalables/egenix-mx-base tar.gz ~# cd egenix-mx-base ~# /usr/local/bin/python/ setup.py build ~# /usr/local/bin/python/ setup.py install Em seguida, instalar o pacote experimental. ~# tar zxvf /opt/instalables/egenix-mx-experimental tar.gz ~# cd egenix-mx-experimental ~# /usr/local/bin/python/ setup.py build ~# /usr/local/bin/python/ setup.py install 5

6 Foram detectados problemas com a compilação dos pacotes mxnumbers. Caso ocorra esse problema, serão feitos comentários para as linhas que façam referência a essas bibliotecas no arquivo mxexperimental.py. Depois que essas linhas forem comentadas, fazer novamente o build e o install Instalação do Zope Descompactar e instalar: ~# tar zxvf /opt/instalables/zope final.tar.gz ~# cd Zope final ~#./configure -prefix /opt/zope final ~# make ~# make install 1.8. Criação de uma instância do Zope A instância do Zope será criada com o seguinte comando> ~# /opt/zope final/bin/mkzopeinstance.py Será solicitado um diretório para nossa instância do Zope: /opt/zope-2.9.4/web Serão solicitados um usuário e uma senha para o administrador do Zope 1.9. Instalação de produtos do Zope - Plone 2.5: Instalar o Plone na pasta selecionada de produtos do Zope (no caso UPM /opt/zope-2.9.4/web/producs): ~# cd /opt/zope-2.9.4/web/products ~# tar zxvf /opt/instalables/plone-2.5-universia.tar.gz Depois de descompactados, mover os diretórios para o diretório principal. ~# cd /opt/zope-2.9.4/web/products ~# cd Plone-2.5-universia ~# mv *.. ~# cd.. ~# rm rf Plone-2.5-universia O Plone vem com um produto chamado Five, usado como ponte entre as versões do Plone. Este produto não é necessário em nosso ambiente, portanto deve ser eliminado da pasta de produtos. ~# cd /opt/zope-2.9.4/web/products 6

7 ~# rm rf Five - educommons: Descompactar o educommons na pasta de produtos: ~# cd /opt/zope-2.9.4/web/products ~# tar zxvf /opt/instalables/educommons universia.tar.gz É necessário mover as pastas contidas na pasta que foi descompactada para o diretório de produtos: ~# cd /opt/zope-2.9.4/web/products ~# mv /educommons universia/*. ~# rm rf educommons universia O educommons precisa do pacote DublinCoreExtensions, que deve ser movido para o diretório lib/python do diretório instância do Zope. ~# cd /opt/zope-2.9.4/web/products/ ~# mv DublinCoreExtensions../lib/python - FCKEditor: Descompactar na pasta de produtos: ~# cd /opt/zope-2.9.4/web/products ~# tar zxvf /opt/instalables/fckeditorplone_2.2.1.tar.gz - Configuração do Zope: Depois que todo o processo estiver instalado, será necessário configurar o site. A primeira coisa a fazer será criar um usuário e um grupo para o Zope. ~# /usr/sbin/groupadd zope ~# /usr/sbin/useradd g zope s /bin/false d /opt/zope zope Depois de criar usuário e grupo, alterar as autorizações: ~# cd /opt/zope-2.9.4/web/products ~# chgrp R zope * ~# chmod go-w * O Zope também precisará de autorização para gravar no diretório de logs e em seus arquivos de bases de datos. ~# cd /opt/zope-2.9.4/web/ ~# chgrp zope log var ~# chmod g+w log var 7

8 É necessário editar o arquivo de configurações do Zope (zope.config), localizado na pasta /etc da instância do Zope. Eliminar o comentário e alterar a linha que designa um usuário efetivo: effective-user zope Estabelecer a porta default a ser utilizada pelo Zope (a configuração padrão é 8080). <http-server> # valid keys are address and force-connection-close Adress 8080 # force-connection-close on </http-server> Para iniciar o Zope: ~# cd /opt/zope-2.9.4/web/ ~# bin/zopectl start Outras diretrizes de controle do Zope ~# bin/zopectl stop ~# bin/zopectl restart Copiar o pacote ocwuniversia.zxep na pasta de importação do Zope (carpeta /import). ~# cd opt/instalables/ ~# mv ocwuniversia.zexp /opt/zope-2.9.4/web/import Agora, importar o educommons partindo do painel de controle do Zope. Gravar no navegador (se tiver sido selecionada a porta 80, não será necessário especificar a pasta na url): name>:8080/manage Quando estiver dentro da Interface de Administração do Zope (ZMI), clicar no botão import/export: 8

9 Na nova tela, no menu suspenso Import file name, selecionar ocwuniversia.zexp Clicar em Import e o novo site educommons estará pronto. Para acessar o novo site educommons (se a porta escolhida for 80, não será necessário especificar a porta na url): name>:8080/ 9

10 2. Configuração do educommons Em primeiro lugar, digitar o login de administrador para acessar a área restrita do educommons. Nas opções pessoais, clicar em Configuración de educommons. As seguintes opções serão visualizadas: 2.1. Adicionar/excluir produtos (Agregar/Quitar productos) Aqui é possível instalar e desinstalar uma série de produtos adicionais, Personalizar a aparência do educommons (Personalizar la apariencia de educommons) Nesta área é possível personalizar as cores e imagens do educommons. As imagens são carregadas do próprio computador para a plataforma clicando no botão examinar. Para as cores, é necessário incluir o código da cor desejada Registro de erro (Registro de error) 10

11 Aqui é disponibilizada a lista com os erros ocorridos na plataforma, detalhando hora, usuário e exceção (erro). Ao clicar neste último, o sistema redirecionará para uma tela na qual são fornecidas mais informações sobre o erro Configuração de idioma (Configuración del lenguaje) Aqui são selecionados e ativados os idiomas, que serão visualizados em forma de bandeiras do país correspondente ao idioma. Muitos dos conteúdos não estão totalmente traduzidos, portanto, na configuração default será usado o idioma selecionado no menu suspenso inicial Configuração de (Configuración del correo) Aqui é configurado o para o portal Configuração de Busca (Configuración de Búsqueda) É aqui onde são configuradas as diferentes opções de busca Preferências do site (Preferencias del sitio) Esta página não armazena as alterações realizadas. Para configurar o site é preciso ir à opção interfaz de administración de zope (seção 2.9.1) 11

12 2.8. Administração de Usuários e Grupos (Administración de Usuarios y Grupos) Nesta seção, são criados os novos usuários e é possível visualizar os usuários já cadastrados. Para adicionar um novo usuário, é preciso clicar em Agregar un nuevo usuario e aparecerá um formulário, que deve ser preenchido com nome completo, um nome de usuário, um endereço de , a senha e sua confirmação. Por último, existe a possibilidade de enviar a senha por para o usuário. Há duas opções para visualizar os usuários: buscar diretamente um usuário, digitando algum dado sobre ele e clicando em buscar; ou clicar em "mostrar todo" para visualizar a lista de todos os usuários do site Interface de administração do zope (Interfaz de Administración de zope) O Zope é um servidor de aplicativos web escrito na linguagem de programação Python. Pode ser administrado quase totalmente com o uso de uma interface de usuário baseada em páginas da internet. Nele são configuradas muitas das preferências do educommons. Para acessar, é necessário digitar o caminho do servidor seguido de "manage". Por exemplo gea.gate.upm.es/manage Será solicitado o usuário de administração criado na instalação do Zope. 12

13 Preferências do site (Preferências del sitio) Na página principal da interface de administração do Zope (ZMI) no site criado para o OCW, clicar na aba Properties. Aparecerá a seguinte tela, na qual será possível ajustar as preferências do site OCW. 13

14 Para salvar as alterações, clicar em Save changes Configuração de licenças Para modificar a configuração de licenças dentro do site OCW, é preciso acessar a opção portal_contenlicensing e dentro da página, entrar em Properties Metadados É possível incluir uma série de Palabras clave (palavras-chave) na área de metadados, que aparecerão no gestor como configuração default. Para fazer isso é preciso entrar no site OCW (no Zope) no "portal_metadata. 14

15 Clicar na aba Elements e dentro dela, selecionar subject. Em "Vocabulary" são adicionadas todas as palavras chaves desejadas Template de Categorias Ao criar uma categoria no educommons, como configuração default aparece um template, cujo conteúdo pode ser alterado depois de baixado em um computador. Depois de feita a alteração, simplesmente fazer novamente o upload no servidor. O título do template é template_department_home.zpt e está no servidor em: /opt/zope-2.9.4/web/products/educommons/skins/templates/ Tradução Quanto aos idiomas, deve-se adicionar em: /opt/zope2.9.4/web/products/educommon/i18n os arquivos plone-es.po e educommons-es.po Nesses arquivos está a tradução para o espanhol dos textos do educommons Sindicalização de conteúdos O Educommons inclui funções de geração de arquivos em formato RSS e de configuração de suas atualizações. É aconselhável ativar a geração de fontes RSS para a sindicalização (distribuição) dos conteúdos em todo o site OCW, e dos conteúdos de cada categoria. Para acessar o formulário de ativação/desativação/configuração da sindicalização de conteúdos, é preciso adicionar o nome do formulário 15

16 synpropertiesform à URL da categoria que se deseja tratar. Dessa forma, a URL para acessar o formulário da "Categoria 1" seria 1/synPropertiesForm, e para acessar o formulário de todo o site OCW, a URL seria São passíveis de configuração os seguintes elementos: Período de atualização (Período de actualización) Freqüência de atualização (Frecuencia de actualización) Data base de atualização (Fecha base de actualización) Número máximo de itens a serem incluídos em cada atualização (Número máximo de ítems que serán incluidos en cada actualización) Configuração do FCKeditor (Configuración del FCKeditor) Nesta seção é possível selecionar a aparência desse editor e escolher a quantidade de funções desejadas. É possível também configurar a opção de inserir links para conteúdos (insertar/editar vínculo) incluídos no servidor. Essa opção é muito importante para facilitar o trabalho do professor ao adicionar documentos nas seções de um curso. Para ativar essa possibilidade, selecionar Allow Server browsing. Ao selecionar essa função, aparecerão mais opções para configuração, como o tipo de autorização de acesso do usuário ou de qual pasta é possível visualizar os conteúdos. É necessário também ativar a opção Allow Link objects by UID. É possível fazer com que o FCKeditor seja usado como o editor HTML default para todos os usuários. O procedimento para isso é acessar do ZMI a seção portal_memberdata e clicar na aba properties. Quando estiver nessa aba, designar o valor FCKeditor ao atributo "wysiwyg_editor". 16

17 2.11. Eliminação do alta de usuário (cadastro de usuário) Por default, o educommons permite cadastrar qualquer usuário. Esse usuário não tem nenhuma permissão perante o gestor diferente de qualquer outro usuário anônimo. Para eliminar essa função, ir ao Zope (no ZMI): Dentro do site OCW no portal_registration : É necessário desmarcar a opção Visible?, para que não seja visualizado Alterar imagem corporativa que aparece nas categorias e cursos Para alterar a imagem que aparece como configuração padrão nos templates das categorias, cursos e sobre o professor, é preciso substituir a imagem defaulteducom.gif localizada em: 17

18 /opt/zope-2.9.4/web/products/educommons/skins/educommons_images Incluir novidades e avisos na página principal Caso queira incluir uma página no início de cada sessão de usuário contendo avisos, será necessário inserir em: /tu_sitio/portal_skins/custom/login_success Exatamente antes de: <div tal:condition="not:js_enabled"> <p i18n:translate="description_javascript_advantage"> You can take fuller advantage of the features of this site if you enable javascript in your browser {???}. </p> O seguinte: <br><br><br><b>novedades</b> <hr> </p> <div style="background-color:#8da8c2; padding-bottom:5px; padding-top:5px"><img src="./imagenes/avisos.gif" width="24" height="24"> Seu texto (é possível inserir uma html simples)</div> <div style="background-color:#d7e0e3; padding-bottom:5px; padding-top:5px"> Seu texto (é possível inserir uma html simples)</div> <div style="background-color:#8da8c2; padding-bottom:5px; padding-top:5px"><img src="./imagenes/avisos.gif" width="24" height="24"> Seu texto (é possível inserir uma html simples)</div> Esse procedimento pode ser repetido quantas vezes for necessário, e alterando a cor do div para que seja ajustada à aparência do site. 3. Administração de categorias e cursos O administrador da plataforma é a pessoa responsável pela criação das diferentes categorias (consultar a seção Adicionar uma categoria na introdução ao ambiente educommons ) dentro das quais os cursos estão inseridos. As categorias devem ser publicadas para possibilitar a visualização dos cursos inseridos. Por outro lado, cada professor deve publicar seu curso, com suas respectivas seções e conteúdos, para permitir a visualização por qualquer pessoa que acesse a plataforma Adicionar um curso novo Selecionar uma categoria correspondente ao curso na barra de navegação, e adicionar; clicando na barra de ações em agregar un nuevo item. 18

19 Aparecerá um menu suspenso, no qual se deve selecionar a opção curso. Na página seguinte, preencher o nome do curso (título). Ao introduzir o template, o nome será substituído pelo existente no template, e será necessário introduzir novamente o nome do curso. É importante que o nome digitado antes de importar o template seja idêntico ao digitado posteriormente. Após digitar o título, clicar em guardar (arquivar) Importar o template do curso Em primeiro lugar, baixar da plataforma, o template institucional para cursos. Quando o template estiver disponível no computador, clicar na janela herramientas (ferramentas) do menu superior. Aparecerá a tela: 19

20 Selecionar a opção importación/exportación de IMS. Clicar em examinar (procurar) e buscar o template no computador. Em seguida clicar em subir para fazer o upload do template no EduCommons. Depois de feito o upload, voltar ao curso plantilla_curso_ocw com o navegador superior. Quando estiver dentro do curso, clicar na opção editar no navegador superior e alterar o título do curso, acrescentando uma descrição e a data em que foi disponibilizado em Term. 20

21 A identificação, "ID del curso", deve permanecer vazia, pois não é utilizada. Em seguida, modificar com o editor HTML (FCKeditor) o template das informações gerais do curso, substituindo a informação existente no template pelos dados do curso a ser inserido. (Para mais informações sobre o editor, consultar a introdução ao ambiente educommons). 21

22 Na seção Adicionar um curso do manual Introdução ao ambiente educommons são disponibilizadas as explicações sobre como inserir um link, passo a passo. A opção de subir contenidos (fazer o upload de conteúdos) serve para carregar no EduCommons um arquivo externo em substituição ao template. É recomendável não substituir o template, para manter a uniformidade entre os diferentes cursos. Por último, excluir os direitos autorais do curso. Para isso, selecionar o campo "Copyright revisado". É importante eliminar o Copyright, pois se isso não for feito, o educommons não permitirá a publicação do conteúdo. Clicar em guardar para criar o curso e voltar à área de conteúdos. 22

23 4. Criação de grupos Inicialmente, o educommons permite criar cursos com um usuário (professor) para gerenciá-lo, sendo ele a única pessoa a ter acesso e controle dos conteúdos e seções do curso, com exceção do administrador do gestor. Caso queira que vários usuários possam gerenciar um curso, será necessário criar um grupo de trabalho no Zope e em seguida autorizar que esse grupo acesse o curso por meio do educommons. Em primeiro lugar, é preciso criar os usuários do grupo no educommons. Em seguida, é preciso acessar o administrador do zope (ZMI). No site OCW, acessar acl-users e depois source_groups : Em source_groups o grupo será criado clicando em add a group (adicionar um grupo): Em seguida, criar uma "id del grupo" (que é a forma como o grupo será visualizado no educommons), um nome e uma descrição para ele. Por fim, clicar em Add group para salvar o grupo. 23

24 Em seguida, aparecerá o grupo criado, juntamente com os demais grupos, caso existam. Para adicionar os usuários, clicar sobre o sinal de interrogação?. aparecerá na página seguinte: Em Principal ID, especificar o nome completo do usuário e clicar em Search. Caso o usuário já exista, ele aparecerá no quadro "Available". Usando a flecha que aponta para o lado esquerdo, transferir o usuário para o quadro Active para incluílo no grupo. O mesmo procedimento deve ser adotado para os demais usuários do grupo. Depois de introduzir todos os usuários no grupo, o administrador do gestor criará o curso no educommons. E na URL na página principal do curso, adicionar /folder_localrole_form. Exemplo: Dessa forma, será redirecionado à página de edição de autorizações do curso. Dentro dela, na seção Agregando permisos de compartición a grupos (adicionar autorizações de compartilhamento para grupos) em Términos de búsqueda (termos da busca), digitar o nome do grupo e clicar em efectuar búsqueda : Caso o grupo já exista, selecionar e atribuir o papel de "Proprietário". 24

25 Por último, clicar em asignar rol local a grupo(s) seleccionado(s) (atribuir função local para os grupos selecionados). A partir desse momento, todos os usuários do grupo selecionado poderão acessar e editar todos os conteúdos e seções do curso. 25