Dokumentacja Moodle: Przewodnik kodowania
Przewodnik kodowania Moodle
Zasady ogólne
Wszystkie pliki powinny posiadać rozszerzenie .php.
Wszystkie informacje na temat praw autorskich powinny zostać zachowane. Możesz dodać własne, jeśli zajdzie taka potrzeba.
Każdy plik powinien zawierać główny plik config.php.
Każdy plik powinien sprawdzać, czy użytkownik jest zalogowany prawidłowo, korzystając z funkcji require_login() i isadmin(), isteacher(), iscreator() lub isstudent().
Wszystkie dostępy do bazy danych powinny opierać się na funkcjach zawartych w lib/datalib.php, jeśli to tylko możliwe. Umożliwia to szeroką kompatybilność platformy z wieloma typami baz danych. Wszystkie inne odwołania SQL powinny być : przenośne między platformami; ograniczone do określonych funkcji w twoim kodzie (zazwyczaj plik lib.php); oraz wyraźnie zaznaczone.
Powinna istnieć możliwość przetłumaczenia wszystkich łańcuchów znaków - utwórz nowy tekst w pliku znajdującym się w katalogu "lang/en" i odwołuj się do niego za pomocą funkcji get_string() lub print_string().
Powinna istnieć możliwość przetłumaczenia wszystkich plików pomocy - utwórz nowe teksty w plikach w katalogu "en/help" i odwołuj się do nich za pomocą funkcji helpbutton().
Styl kodowania
Nie korzystaj z tabulatorów. Wykorzystuj wcięcia składające się z czterech znaków odstępu.
Nawiasy muszą otaczać każdy blok kodu, nawet jeśli składa się on tylko z jednej linii. Moodle wykorzystuje następujący styl :
if ($quiz->attempts)
{
if ($numattempts >
$quiz->attempts)
{
error($strtoomanyattempts,
"view.php?id=$cm->id");
}
}
Więcej treści pojawi się tu w przyszłości ... ten dokument nie jest nawet bliski ukończenia!
Dokumentacja Moodle
Version: $Id: faq.html,v 1.6 2003/03/30 13:54:28
moodler Exp $
Wyszukiwarka
Podobne podstrony:
C Coding Techniques for Intel Architecture ProcessorscodingstandardsTworzenie Coding profil NCSEXPERTCodingStyle (3)CodingErrorActioncodingBash Style Guide an Coding Standard [EN]codingcodingcodingcodingcoding guidelines03 Coding Plug05d Coding and Programmingcodingcoding coding programmingcoding guidelinescodingwięcej podobnych podstron