moodle/lang/pl/docs/coding.html
2003-09-19 19:23:14 +00:00

157 lines
4.5 KiB
HTML

<html>
<head>
<title>Dokumentacja Moodle: Przewodnik kodowania</title>
<link rel="stylesheet" href="../theme/standard/styles.php" type="TEXT/CSS">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-2">
<style type="text/css">
<!--
li {
padding-top: 10px;
}
.question {
font-size: medium;
font-weight: bold;
font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;
border: 1px dotted;
padding: 10px;
background-color: #EEEEEE;
}
.answer {
font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;
font-size: medium;
border: none;
padding-left: 40px;
}
-->
</style>
<style type="text/css">
<!--
.normaltext {
font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;
font-size: medium;
border: none;
padding-left: 10px;
}
.answercode {
font-family: "Courier New", Courier, mono;
font-size: small;
border: none;
padding-left: 60px;
}
.questionlink {
font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;
font-size: medium;
border: none;
padding-left: 40px;
}
-->
</style>
<style type="text/css">
<!--
.examplecode {
font-family: "Courier New", Courier, mono;
font-size: small;
border: thin dashed #999999;
background-color: #FBFBFB;
margin: auto;
padding: 30px;
height: auto;
width: auto;
}
-->
</style>
</head>
<body bgcolor="#FFFFFF">
<h2>Przewodnik kodowania Moodle</h2>
<h2 class="normaltext">Zasady ogólne</h2>
<ol class="normaltext">
<li>Wszystkie pliki powinny posiadaæ rozszerzenie .php.</li>
<li>Wszystkie informacje na temat praw autorskich powinny zostaæ zachowane. Mo¿esz dodaæ w³asne, je¶li zajdzie taka potrzeba.</li>
<li>Ka¿dy plik powinien zawieraæ g³ówny plik config.php.</li>
<li>Ka¿dy plik powinien sprawdzaæ, czy u¿ytkownik jest zalogowany prawid³owo, korzystaj±c z funkcji require_login() i isadmin(), isteacher(), iscreator() lub isstudent().</li>
<li>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. </li>
<li>Powinna istnieæ mo¿liwo¶æ przet³umaczenia wszystkich ³añcuchów znaków - utwórz nowy tekst w pliku znajduj±cym siê w katalogu &quot;lang/en&quot; i odwo³uj siê do niego za pomoc± funkcji get_string() lub print_string().</li>
<li>Powinna istnieæ mo¿liwo¶æ przet³umaczenia wszystkich plików pomocy - utwórz nowe teksty w plikach w katalogu &quot;en/help&quot; i odwo³uj siê do nich za pomoc± funkcji helpbutton().</li>
</ol>
<p>&nbsp;</p>
<h2 class="normaltext">Styl kodowania</h2>
<ol class="normaltext">
<li>Nie korzystaj z tabulatorów. Wykorzystuj wciêcia sk³adaj±ce siê z czterech znaków odstêpu.</li>
<li>Nawiasy musz± otaczaæ ka¿dy blok kodu, nawet je¶li sk³ada siê on tylko z jednej linii. Moodle wykorzystuje nastêpuj±cy styl :
<p class="examplecode"> </font><font color="#006600">if (</font><font color="#0000CC">$quiz</font><font color="#006600">-&gt;</font><font color="#0000CC">attempts</font><font color="#006600">)
{<br />
&nbsp;&nbsp;&nbsp;&nbsp;if (</font><font color="#0000CC">$numattempts </font><font color="#006600">&gt;
</font><font color="#0000CC">$quiz</font><font color="#006600">-&gt;</font><font color="#0000CC">attempts</font><font color="#006600">)
{<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000CC">error</font><font color="#006600">(</font><font color="#CC0000">$strtoomanyattempts</font><font color="#006600">,
</font><font color="#CC0000">"view.php?id=$cm</font><font color="#006600">-&gt;</font><font color="#CC0000">id"</font><font color="#006600">);<br />
&nbsp;&nbsp;&nbsp;&nbsp;}<br />
}</font></p>
</li>
<li>Wiêcej tre¶ci pojawi siê tu w przysz³o¶ci ... ten dokument nie jest nawet bliski ukoñczenia!</li>
</ol>
<p align="center" class="normaltext">&nbsp;</p>
<hr>
<p align="CENTER"><font size="1"><a href="." target="_top">Dokumentacja Moodle</a></font></p>
<p align="CENTER"><font size="1">Version: $Id: faq.html,v 1.6 2003/03/30 13:54:28
moodler Exp $</font></p>
</body>
</html>