ADA stand for Ambiente Digitale di Apprendimento. It is a knowledge and e-learning management system that allows you to create, administer and follow courses via the Internet or intranet with ease and flexibility.
CONTENTS OF THIS FILE
- How to install
- Customize the layout
- Localization and languages
- Extra configuration
- System setup
- Add one provider
- user preconfigured
- Apache 2.2.21>
- MySql 5.1.6 >
- PHP 5.3.*> compiled with support for MySql, XML, GD, PDO
- PEAR::XML_Parser 1.3.x>
- PEAR 1.9.x>
- PEAR::XML_Util 1.2.x>
HOW TO INSTALL
copy all files and directory tree in root directory
create at least two DB (each courses' provider has his own DB. if you have 2 providers, you need 3 DB. One common DB and 2 providers DB.
- ada_common --> DB common.
- ada_provider0 --> DB of the provider 0.
- ada_provider1 --> DB of the provider 1.
import ada_common.sql in ada_common
import ada_provider0.sql in ada_provider0
import ada_provider_empty.sql in ada_provider1 (if you need one more provider)
copy config_path_DEFAULT.inc.php in config_path.inc.php
modify config_path.inc.php writing the correct root path ex. if you have copied the files and directory in /var/www/ada you have to modify it in the follow way:
copy config/config_install_DEFAULT.inc.php in config/config_install.inc.php
- change the * ADA Common database section
- change the * ADA default provider
- change the * Default admin mail address
- change the URL define. Pay attention to not remove the trailing // js_import define('HTTP_ROOT_DIR','http://ada.lynxlab.com');
- optionally change the Default template family (only if you want to use a different layout family)
- optionally change define('PORTAL_NAME','ADA - e-learning ');
copy the directory clients_DEFAULT in clients
modify clients/client0/client_config.inc.php (each provider has own directory. es.: provider 1 has client1)
- change the DB access parameter
- change the timezone of the provider if you need
if you have more providers you have to create more client_config.inc.php es.: 2 providers. You must have clients/client0/client_config.inc.php and clients/client1/client_config.inc.php. in client1/client_config.inc.php the constant name must be CLIENT1_DB_NAME, CLIENT1_DB_USER, CLIENT1_DB_PASS, CLIENT1_DB_HOST, CLIENT1_TIMEZONE
change the permission of the directory services/media/ the web server must be able to write in it
change the permission of the directory upload_file/ the web server must be able to write in it
change the permission of the directory docs/ the web server must be able to write in it
change the permission of the directory log/ the web server must be able to write in it
change the informations of the news editing the file: browsing/news_language (ex.: news_en is the news in english) or using edit_news.php after logon as admin
configure the widgets loaded in home page copy widgets/main/index_DEFAULT.XML in widgets/main/index.xml see widgets/main/index.xml in order to know how to configure to enable the RSS widget cache, set proper permission to the widgets/cache
copy modules/test/config/config_DEFAULT.inc.php in modules/test/config/config.inc.php and edit the copied file to suite your needs. Basically only the
ADA_REDIRECT_TO_TESTconstant can be either
falsewhether you want ADA test nodes to be redirected to modules test node or not.
CUSTOMIZE THE LAYOUT
customize the layout in the directory templates and css.
The file layout/layout_family/header.tpl contains the header of all pages. You can change the logo and the header modifying the file layout/layout_family/header.tpl
The structure of the directories that contain the layout is:
LOCALIZATION AND LANGUAGES
At the moment ADA is translated in the following languages:
Each translation is stored in a table contained in the DB common. the name of the table is messaggi_language (ex.: english messaggi_en)
Translation of messages and GUI
The system translates at real time all the interface (buttons, links, labels) and all the messages that are to be sent to the user (welcome message excluded, see below). After logging into ADA as Switcher or Admin, go to this address: http://your_domain_of_wisp/switcher/translation.php
You'll see a small form to search the sentences or part of them.
- Write in this form the sentence you want to translate (or modify)
- The system will show a list of the sentences similar to the one you wrote in the form, if any.
- click on modify in the line in which you can read the sentence you wish to translate.
- replace the missing or wrong sentence with the correct one
- click on "update"
- Go back
Note and suggestions.
In order to have the experience of ADA use and to check the correct translation in context, we suggest you to open two different web browsers (NOT two windows of the same browser), say A. Firefox and B. Google Chrome.
- In browser "A" you can login as user or pratitioner or switcher and use the ADA platform normally.
- In browser "B" you have to login as switcher and go to the translation module
- When, navigating in browser "A", you may find a sentence not translated in your language, or with a wrong translation,
- in browser "B" you can search for that sentence and change its translation Note that after the translation of each sentence you have to reload the page in the browser "A" in order to see the newly translated sentence
How to add a language.
- You have to add a record to the table "lingue" (which means language in italian) contained in the db common using a tool like phpmyadmin. ex.: to add french language you have to add a record like this id: 7, name language: français, code: fr, table identifier: fr,
- You can copy the table messaggi_en contained in the db common to messaggi_language using a tool like phpmyadmin (ex.: french messaggi_fr).
- you can use the translation module (see Translation of messagges and GUI section above) or in alternative you can export the content of the table, translate all and reimport the table using a tool like phpmyadmin.
Welcome message mail
You can change the text of the welcome message sended to the user just registered: /docs/welcome_language.txt (ex.: /docs/welcome_en.txt english message)
the directory docs contains also the help for the user. You can change the help by editing each single file.
You can set one public course for provider 0 (in case MULTIPROVIDER is set to true, otherwise each provider has his own public course defined in clientX.inc.php by the value of the constant PUBLIC_COURSE_ID_FOR_NEWS).
The default public id course of provider 0 is definied in config/config_install.inc.php by the value of the constant PUBLIC_COURSE_ID_FOR_NEWS
change the news in home page. You can change the news from inside the platform, logging in with administer user and clicking the voice "edit news" in act (or do) menù You can also modify it, changing the files docs/news/news_language.txt (es.: english news_en.txt) You can open it and change using any text editor. It is possibile to use HTML tag.
Create the users of type switcher (coordinator) and Tutors. How to do:
- log on with the platform Admin,
- click on Do menù,
- click on add user,
- choose the provider to which associate the user.
Arrangement of courses provided
How the ADA platform works
- In the ADA platform are defined the courses delivered (they are saved in DB common)
- Each provider creates their own courses (they are saved in DB indicated in the clientX/client_conf.inc.php)
- Each course created by the provider is (automatically) linked to the platform courses (saved in DB common).
- Each provider has to create at least one instance of the course (the classroom) in order to allow the students to subscribe the instance
How to do:
- log on with the switcher account,
- click on Do menù,
- click on add a course
- click on add instance, near the course
Users have to register in the platform in order to participate the courses. (the users that have registered in ADA receive an email to confirm the registration)
Add one provider
to add a provider, you need to do the following tasks:
- create a new DB
- import the sql ada_provider_empty.sql into the new DB
- follow the steps 11 and 12
- login as admin
- create a new provider (from menù actions) take care to write in the field "Puntatore al database" the same name of the directory contained in clients (ex.: client1)
- create the new coordinator user for the provider just created
predefined USERS are:
- adminAda --> Super Admin
- autoreAda0 --> author of first provider
- tutorAda0 --> tutor of first provider
- switcherAda0 --> Admin of first provider
- studenteAda0 --> Student of first provider
passwords are the same of the username