Manual i Zhvilluesit

Ky dokument përshkruan diçka mbi dizenjimin e Moodle dhe si mund të kontribuoni ju.

Për momentin ky dokument është pak - dokumentim më i mirë do të vijë!

Seksionet në këtë dokument:

1. Arkitektura e Moodle
2. Si mund të kontribuoni
   • Aktivitetet e të mësuarit
   • Stilet
   • Gjuhët
   • Skemat e databazës
   • Formati i Kursit
   • Dokumentimi dhe artikujt
   • Pjesmarrsit në gjurmimin e të metave

1. Arkitektura e Moodle

Nga pikpamja e administrimit të sistemit, Moodle është dizenjuar sipas këtyre kritereve:

1. Moodle duhet të ekzekutohet në sa më shumë platforma
   
   Aplikimet në web që ekzekutohen në shumicën e platformave janë në PHP e kombinuar me MySQL, dhe në këtë lloj është zhvilluar edhe Moodle, ajo ekzekutohet në Linux, Windows, dhe Mac OS X. Moodle gjithashtu përdor biblotekën ADOdb për konceptimin e databazës, e cila nënkupton që Moodle mund të përdorëmë shumë se 10 lloje të ndryshme databazash (për fat të keq, akoma nuk mundet të ndërtohen tabela me të gjitha këto lloje databazash - në të ardhmen më shumë).
   
   
2. Moodle duhet të jetë i lehtë në instalim, mëso dhe modifiko
   
   Prototipet e hershëm të Moodle (1999) u ndërtuan duke përdorur Zope - një server të aplikimeve në web me gjuhë të avancuar të orientuar drejt objekteve (object-oriented). Fatkeqësisht u duk se megjithse teknologjia ishte mjaft e mirë, kishte një rrugë mjatt të vështirë për të mësuar dhe nuk ishte shumë fleksible për sa i takon administrimit të sistemit. Gjuha e skriptimi PHP, nga ana tjetër, është mjaft e lehtë pë tu kapur (veçanërisht nëse keni programuar më parë me ndonjë gjuhë skriptimi tjetër). Herët unë vendosa të mënjanoj përdorimin e dezinjimit të klasave class-oriented - por, ta ruaj atë vetëm për të kuptuar risitë. U arrit ripërdorimi i kodeve nga bibliotekat e funksioneve të emërtuar qartë dhe skedarët skript konsistentë. PHP është gjithashtu i lehtë për tu instaluar (është i vlefshëm për çdo platformë) dhe shumica e shërbimeve të hostimit web e kanë atë si standart.
   
   
3. Ai është i lehtë për upgrade nga një version në një tjetër
   
   Moodle e di se vili version është (ashtu si të gjitha versionet e moduleve plug-in) dhe është ndërtuar një mekanizëm i tillë që Moodle mund të bëjë upgrade vetë të versioneve të reja (psh ai mund të riemërojë tabelat e databazave dhe të shtojë fusha të reja). Nëse përdor CVS në Unix psh, jep thjesht komandën "cvs update -d" dhe mandej vizito faqen home page për të kompletuar upgrade.
   
   
4. Duhet të mundësohet rritja
   
   Moodle ka një numër elementesh si modulare, terms, aktivitete, gjuhët e interfejsit, skema databaze dhe formate kursesh. Kjo lejon që seicili të shtojë elemente te codi batë kryesor ose ti shpërndajë ato ndarazi. Më shumë për këtë ka në sektionin tjetër.
   
   
5. Ajo duhet të përdoret së bashku me sisteme të tjerë
   
   Një gjë që Moodle e bën është se i ruan të gjitha skedarët për një kurs brenda një direktorie, të vetme normale. Kjo e lejon administratorin e sistemit të japë forma të ndryshme të aksesimit të skedarëve për çdo mësues, të tilla si Appletalk, SMB, NFS, FTP, WebDAV dhe etj. Modulet e autentifikimit i lejojnë Moodle të përdorë LDAP, IMAP, POP3, NNTP dhe databaza të tjera si burime për informacionin e përdoruesit. Ka akoma punë për të bërë. Tipare të planifikuara për Moodle në versionet e ardhme janë: importimi and eksportimi i të dhënave të Moodle duke përdorur formatet XML (që përfshijnë edhe IMS dhe SCORM); dhe rritjen e përdorimit të fletëve të stileve për formatimin e interfeisit (në mënyrë që ai të integrohet vizualisht në faqe të tjera të web site-eve).

2. Si mund të kontribuoni

Siç u përmend më lart, Moodle ka një numër tiparesh që janë modulare. Edhe nëse ju nuk jeni një programues, ka gjëra që ju mund të ndihmoni ose ti ndryshoni.

Aktivitete të të mësuarit

Deri tani ka shumicën e moduleve të rëndësishme, dhe qëndrojnë në direktorinë 'mod' . Ka shtatë module default: assignment, choice, forum, journal, quiz, resource, dhe survey. Seicili modul është në një subdirektori të veçantë dhe përbëhet nga elementet e mëposhtëm (plus skripte extra unike për çdo modul):

• mod.html: një formë për të ndërtuar ose update-uar një shembull të këtij moduli
• version.php: përcakton disa meta-info dhe jep dodin e upgrade-imit
• icon.gif: një ikonë 16x16 icon për modulin
• db/: SQL zbraz të gjitha tabelat e kërkuara db dhe të dhënat (për çdo tip databaze)
• index.php: një faqe për të listuar të gjitha shembujt në një kurs
• view.php: një faqe për të parë një shembull të veçantë
• lib.php: çdo/të gjithë funksionet e përcaktuar nga moduli duhet të jenë këtu. Nëse emri i modulit është i quajtur widget, atëhere funksionet e kërkuar përfshijnë:
  • widget_add_instance() - codi për të shtuar një shembull të ri të widget
  • widget_update_instance() - codi për të update-uar një shembull ekzistues
  • widget_delete_instance() - kodi për të fshirë një shembull
  • widget_user_outline() - për një shembull të dhënë, jep një përmbledhje të kontributit të përdoruesit
  • widget_user_complete() - për një shembull të dhënë, printon detaje të një kontributi përdoruesi
    
  • Për të mënjanuar konfliketet e mundëshme, çdo funksion moduli duhet të emërtohet duke filluar me widget_ dhe çdo konstante që ju përcaktoni duhet të fillojë me WIDGET_
• Së fundi, çdo modul do të ketë ca skedarë gjuhe që përmbajnë stringje për këtë modul. Shih më poshtë.

Mënyra më e lehtë për të filluar një modul aktiviteti të të mësuarit të ri është të përdoret template në mod/newmodule_template.zip. Unzip-o atë dhe ndiq brendinë e skedarit README .

Ju ndoshta pëlqeni të postoni në Aktivitete module forum në Përdor Moodle.

 

Stilet

Stilet (ose lëkurat) përcaktojnë pamjen e një site-i. Një numër temash të thjeshta jepen një paketën kryesore që shpërndahet, por ju mund të krijoni atë tuajën me ngjyrat tuaja, logo-on tuaj, stilin dhe grafikën tusj.

çdo temë është një nëndirektori e "theme" direktorisë, dhe përmban të paktën skedarët e mëposhtëm:

• config.php: përcakton ngjyrat që përdor nëpër gjithë site-in
• styles.php: faqja stil, përmban përcaktimet CSS për elementet standart HTML sikurse shumë elemente të Moodle.
• header.html: E përfshirë në krye të çdo faqeje. Kjo është ajo që ju duhet për të edituar dhe shtuar një logo në krye të faqeve, psh.
• footer.html: E përfshirë në fund çdo faqeje.

Për të krijuar temat tuaja për versionin korent të Moodle:

1. Kopjo një nga folderat e temave ekzistues në një folder me emër tjetër. Unë rekomandoj të fillosh me një nga temat standarte.
2. Edito skedarin config.php dhe fut ngjyrat e tua.
3. Edito skedarin styles.php dhe ndrysho stilet CSS.
4. Edito header.html dhe footer.html për të shtuar logot e reja ose për të ndryshuar pamjen e jashtme.

Vini re se këto hapa janë opsionale - ju mund të bëni një pamje krejt ndryshe të site-it tuaj, thjeshtë duke edituar ngjyrat në config.php

Vini re gjithashtu se ugrade-imet e Moodle mund ti prishin paksa temat, prandaj kontrollo shënimet përkatëse me kujdes nëse po përdor një temë të dhënë.

Në vbeçanti, Moodle 2.0 do të ketë një sistem shfaqjeje krejt të ri, ka mundësi të bazuar në transformimet XSL ose autpute XML nga Moodle. Kjo do të thotë që temat do të kenë format krejt të ndryshëm, por avantazhi do të jetë një nivel më i lartë i përshtatshmërisë (duke përfshirë lëvizjen e elementeve nëpër faqe).

Më shumë diskutime për këtë në Temat forum në Using Moodle. Nëse ju krijoni një temë të këndshme që ju mendoni se të tjerët do ta duan ta përdorin, ju lutem postoni skedarint tuajr zip në forumin e temave!

Gjuhët

Moodle është dizenjuar për ndërkombëtarizim. Seicili nga 'string' ose 'page' teksti që shfaqet si pjesë e interfejsit është vizatuar nga një bashkësi skedarësh gjuhe. çdo gjuhë është një nëndirektori e direktorisë 'lang'. Struktura e direktorisë lang është si më poshtë:

lang/en - direktoria që përmban të gjithë skedsarët e një gjuhe (psh English)

• moodle.php - stringjet për interfejsin kryesor
• assignment.php - stringjet për modulin assignment
• choice.php - stringjet për modulin choice
• forum.php - stringjet për modulin forum
• journal.php - stringjet për modulin journal
• quiz.php - stringjet për modulin quiz
• resource.php - stringjet për modulin resource
• survey.php - stringjet për modulin survey
• .... plus modulet e tjera nëse ka.
  
  Një string thirret nga këta skedarë duke përdorur funksionet get_string() or print_string() . çdo string suporton zevëndësimin e variablave, për të suportuar renditjen e variablave në gjuhë të ndryshme.
  
  eg $strdueby = get_string("assignmentdueby", "assignment", userdate($date));
  
  Nëse një string nuk ekziston në një gjuhë të veçantë, atëhere ai ekuivalenti në English do të përdoret automatikisht në vend të tij.

lang/en/help - përmban të gjitha faqet e help-it (për popup-et e context-sensitive help)

Faqet help kryesore janë këtu, kurse faqet help specifike për seicilin modul janë në nëndirektoritë me emrin e modulit.

Ju mund të fusni një helpbutton në një faqee me anë të funksionit helpbutton.

psh helpbutton("text", "Kliko këtu për help mbi text");

dhe për modulet:

helpbutton("forumtypes", "tipet e Forumit ", "forum");

Vini re se ju mund të editoni gjuhët, duke përdorur mjetet e administrimit web nën "Kontrollo këtë language". Ko e lehtëson jo vetëm krijimin e gjuhëve të reja por edhe rishikimin e atyre ekzistuese. Nëse ju filloni një gjuhë të re, ju lutem kontaktoni me mua, Martin Dougiamas.

Ju mund ta postoni në Languages forum on Using Moodle.

Nëse mirmbani një gjuhë nga baza ekzistuese, unë mund tu jap juve CVS akses shkrimi te kodet e Moodle kështu që ju mund të mbani direkt skedarët.

Skemat e Databazave

Për një databazë të dhënë me tabela të përcaktuara, komandat e thjeshat SQL të përdorura në Moodle duhet të punojnë mirë me një shumëllojshmëri të gjerë databazash.

Një problem ekziston me krijimin automatik të tabelave të reja në një databazë, me të cilën Moodle ka komunikuar në instalimin fillestar. Meqë çdo databazë është e ndryshme, nuk ekziston akoma një mënyrë për ta bërë këtë të pavaruar nga platform. Për ta suportur këtë në çdo databazë, skemat mund të krijohen që të listojnë SQL e duhura për të krijuar tabela të Moodle në një databazë të veçantë. Këto skedarë në lib/db dhe brenda db nëndirektorisë të çdo moduli.

Aktualisht, vetëm MySQL dhe PostgreSQL janë plotësisht të suportueshme në këtë mënyrë (asnjë nuk ka shkruar skema për llojet e tjera).

Moodle 1.2 do të përdorë një metodë të re skemash XML të pavaruara nga datatbazat (database-independent) që do ta bëjë të gjithë këtë të panevojshme.

 

Formatet e kurseve

Moodle aktualisht suporton tre formate të ndryshme kursesh: weekly, topics dhe social.

Këto janë pak më të lidhur me pjesën tjetër të kodit (dhe prandaj, më pak "pluggable") por është akoma e lehtë të shtohet një i ri.

Nëse ju keni ndonjë ide për formate të ndryshme që ju keni nevojë ose pëlqeni të shikoni, lidhuni me mua dhe do të bëj çmos që ti keni ato në varianetet e ardhëshme.

 

Dokumentimi dhe artikujt

Nëse e ju e ndjeni se mund të shkruani një tutorial, një artikull, një artikull akademik ose ndonjë gjë tjetër rreth Moodle, ju lutem bëjeni!

Vendoseni atë në web dhe sigurohuni që keni futur linkun për http://moodle.org/

 

Pjesmarrje në gjurmimin e të metave

Së fundi, do të desha tu ftoj për tu regjistruar te "bug tracker" at http://moodle.org/bugs kështu që ju mund të skedoni çdo të metë që ju gjeni dhe ndoshta merrni pjesë në diskutimin dhe rregullimin e tyre.

"Bugs" jo vetëm përfshin të meta të software-it në versionin korent të Moodle, por ka ide të reja, kërkesa tiparesh dhe kritika konstruktive mbi tiparet ekzistuese. E bukura e "open source" është se gjithkush mund të marri pjesë në një farë mënyre dhe të ndihmojë krijimin e një produkti më të mirë që të na kënaqë të gjithëve. Në këtë projekt, ju jeni i mirseardhur!

Faleminderit që përdorni Moodle!

Martin Dougiamas, Lead Developer

Dokumentacioni i Moodle

Version: $Id$