~ubuntu-branches/ubuntu/breezy/moodle/breezy

Ba cheart go bhfeicfeá gur féidir beagnach gach rud a dhéanamh leis na feidhmeanna seo. Má tá ort cód SQL a scríobh cinntigh: go bhfuil sé trasardáin; srianta go feidhmeanna sonrúla

laistigh de do chód (de ghnáth comhad lib.php); agus go bhfuil sé marcáilte go soiléir.</li>

<li class="spaced">Ná cruthaigh agus ná húsáid athróga domhanda seachas cinn caighdeánacha

$CFG, $SESSION, $THEME agus $USER.</li>

<li class="spaced">Ba cheart gach athróg a thúsú, nó ar a laghad tástáil gur ann dóibh

trí leas a bhaint as isset() nó empty() sula n-úsáidtear iad.</li>

<li class="spaced">Ba cheart do gach teaghrán a bheith inaistrithe - cruthaigh téacsanna nua sna comhaid

"lang/en" agus glao orthu trí leas a bhaint as get_string() nó print_string().</li>

<li class="spaced">Ba cheart do gachcomhad cabhrach a bheith inaistrithe - cruthaigh téacsanna nua sa chomhadlann

"en/help" agus glao orthu trí leas a bhaint as helpbutton().</li>

<li class="spaced">Cuirtear magic_quotes le sonraí a thagann isteach ón mbrabhsálaí (seolta trí GET nó POST) go huathoibríoch

(aineoinn na socruithe PHP) le gur féidir leat é a chur díreach isteach

sa bhunachar sonraí go sábháilte. Ní mór gach amhshonra eile (ó chomhaid, nó ó bhunachair sonraí)

a éalú le addslashes() sula gcuirtear isteach sa bhunachar sonraí é.</li>

</ol>

<h2>Stíl Códúcháin</h2>

Tá a fhios agam go bhfuil sé beagán achrannach do stíl a athrú

má tá cleachtadh agat ar rud ar leith, ach cuir i gcomparáid an t-achrann sin leis an achrann a bheadh

i gceist dá mbeadh daoine ag iarraidh bun nó barr a bhaint as cód Moodle dá mbeadh meascán stíleanna ann.

Is léir go bhfuil neart buntáistí nó míbhuntáistí le stíleanna a úsáideann daoine éagsúla,

ach tá an stíl reatha ann, agus iarraimid ort cloí leis.

<li class="spaced">Eangú: ba cheart 4 spás a bheith ann go seasmhach.

Ná bain leas as tábanna AR CHOR AR BITH. </li>

<li class="spaced">Ainmneacha athróige: ba cheart gur focail Bhéarla iad atá éasca le léamh,

agus brí leo. Má tá sé iomlán riachtanach go mbeadh níos mó ná focal amháin agat

rith le chéile iad, ach coinnigh chomh gairid agus is féidir iad. Úsáid

ainmneacha iolra le haghaidh eagair d'oibiachtaí.

GO MAITH: $quiz

GO MAITH: $errorstring

GO MAITH: $assignments (le haghaidh eagar d'oibiachtaí)

GO MAITH: $i (ach i lúba beaga amháin)

GO DONA: $Quiz

GO DONA: $aReallyLongVariableNameWithoutAGoodReason

GO DONA: $error_string

</li>

<li class="spaced">Tairisigh: ba cheart iad a bheith i gceannlitreacha i gcónaí,

agus tosú i gcónaí le hainm an mhodúil. Ba cheart na focail a roinnt

le fostríoc.

define("FORUM_MODE_FLATOLDEST",

1);

</li>

<li class="spaced">Ainmneacha feidhme: ba cheart gur focail simplí Béarla a bheadh iontu,

agus go dtosóidis le hainm an mhodúil le coinbhleacht a sheachaint idir na modúil.

Ba cheart focail a roinnt le fostríocanna. Ba cheart réamhshocrú ciallmhar a bheith ag paraiméadair i gcónaí

más féidir. Tabhair faoi deara nach bhfuil spás ar bith idir ainm na feidhme agus na

(lúibíní) a leanann é.

function forum_set_display_mode($mode=0)

{

global $USER,

$CFG;

if ($mode)

{

$USER->mode

= $mode;

} else if (empty($USER->mode))

{

$USER->mode

= $CFG->forum_displaymode;

}

}

</li>

<li class="spaced">Blocanna: ní mór iad a chur idir lúibíní 'catacha'

100

(fiú muna bhfuil ann ach líne amháin). Úsáideann Moodle an stíl seo:

101

if ($quiz->attempts)

102

{

103

if ($numattempts >

104

$quiz->attempts)

105

{

106

error($strtoomanyattempts,

107

"view.php?id=$cm->id");

108

}

109

}

110

</li>

111

<li class="spaced">Teaghráin: ba cheart iad a shainmhíniú laistigh de uaschamóga singil

112

nuair is féidir é, ar mhaithe le luas.

113

$var = 'some text without any

114

variables';

115

$var = "with special characters like a new line \n";

116

$var = 'a very, very long string with a '.$single.' variable in it';

117

$var = "some $text with $many variables $within it";

118

</li>

119

<li class="spaced">Nótaí tráchta: ba cheart dóibh dhá slais nó trí a úsáid

120

agus teacht le chéile go néata leis an gcód.

121

function forum_get_ratings_mean($postid,

122

$scale, $ratings=NULL)

123

{

124

/// Return the mean rating of a post given

125

to the current user by others.

126

/// Scale is an array of possible ratings in the scale

127

/// Ratings is an optional simple array of actual ratings (just integers)

128

129

if (!$ratings)

130

{

131

$ratings

132

= array();     //

133

Initialize the empty array

134

if ($rates

135

= get_records("forum_ratings",

136

"post", $postid))

137

{

138

//

139

Process each rating in turn

140

            foreach

141

($rates as $rate)

142

{

143

....srl

144

</li>

145

<li class="spaced">Spás: ba cheart bheith flaithiúil leis - ná bíodh faitíos ort

146

rudaí a scaipeadh amach roinnt éigin ar mhaithe le soiléireacht. Go ginearálta, ba cheart go mbeadh

147

spás amháin idir lúibíní agus gnáth ráitis, agus gan spás ar bith idir lúibíní agus

148

athróga nó feidhmeanna:

149

foreach ($objects

150

as $key =>

151

$thing) {

152

process($thing);

153

154

}

155

156

if ($x ==

157

$y)

158

{

159

$a

160

= $b;

161

} else if ($x ==

162

$z) {

163

$a

164

= $c;

165

} else {

166

$a

167

= $d;

168

}

169

</li>

170

</ol>

171

172

<h2>Struchtúr Bunachair Sonraí:</h2>

173

174

<li class="spaced">Ní mór do gach tábla réimse id (INT10) uath-incriminteach a bheith aige mar innéacs príomhúil.</li>

175

<li class="spaced">Ní mór don phríomhtábla in dtarlaíonn gach modúl an t-ainm céanna a bheith air is atá ar an modúl (m.sh. widget) agus ar a laghad na réimsí seo a leanas a bheith ann:

176

<ul>

177

<li>id - mar a sonraíodh thuas</li>

178

<li>course - id an chúrsa a mbaineann gach ásc leis</li>

179

<li>name - ainm iomlán gach ásc den mhodúl</li>

180

</ul>

181

</li>

182

<li class="spaced">Ba cheart táblaí eile atá gaolmhar le modúl, a bhfuil eolas iontu faoi 'things', ba cheart widget_things a thabhairt orthu (tabhair faoi deara an t-iolra).</li>

183

<li class="spaced">Ba cheart ainmneacha na gcolún a choinneáil gairid agus simplí, agus na rialacha céanna á leanúint is atá ann d'ainmneacha athróige.</li>

184

<li class="spaced">Nuair is féidir é, má tá tagairt i gcolún do réimse id i dtábla eile (m.sh. widget), ba cheart widgetid a ghlaoch air. (Tabhair faoi deara gur nós réasúnta nua é seo agus nach leantar é i roinnt sean-táblaí)</li>

185

<li class="spaced">Ba cheart réimsí Boole a chur i bhfeidhm mar réimsí beaga slánuimhreacha (m.sh. INT4) a bhfuil 0 nó 1 iontu, le leathnú ar luachanna a éascú ar ball más gá.</li>

186

<li class="spaced">Ba cheart do formhór na dtáblaí réimse timemodified (INT10) a bheith acu a nuashonraítear le ham-stampa reatha trí an bhfeidhm PHP time () a úsáid.</li>

187

</ol>

188

<hr />

189

<a href="." target="_top">Doiciméid Moodle</a>

190

Leagan: $Id$

191

</body>

192

</html>

Older »