diff --git a/lang/ja/admin.php b/lang/ja/admin.php index 03d0c770bd7..d7eeb6a89ac 100644 --- a/lang/ja/admin.php +++ b/lang/ja/admin.php @@ -30,7 +30,7 @@ $string['configdbsessions'] = ' $string['configdebug'] = 'この設定を「Yes」にした場合、PHPのerror_reportingが増加し、より多くの警告が表示されるようになります。これは、開発者のみに便利な設定です。'; $string['configdefaultallowedmodules'] = '上位カテゴリに分類されるコースが作成される場合、デフォルトでどのモジュールを許可しますか?'; $string['configdefaultrequestedcategory'] = 'リクエストされたコースが認証された場合、コースが設置されるデフォルトカテゴリです。'; -$string['configdeleteunconfirmed'] = 'メールによる承認を利用している場合、この値はユーザからの返答を受け付ける期間を指します。この期間の終了後、古い未承認のアカウントは削除されます。'; +$string['configdeleteunconfirmed'] = 'メールによる承認を利用している場合、この値はユーザからの返答を受け付ける期間を指します。この期間終了後、古い未承認のアカウントは削除されます。'; $string['configdenyemailaddresses'] = '特定ドメインから新しいメールアドレスを拒否したい場合は、この欄にスペースで区切って入力してください。他のドメインは全て認められます。例 hotmail.com yahoo.co.uk '; $string['configdigestmailtime'] = 'メール送信する選択をしたユーザに、投稿内容を要約したメールが毎日送信されます。ここでは1日の内で何時に要約メールを送信するか設定します ( 次のcronがここで設定した時間の後に実行されます )。'; $string['configdisplayloginfailures'] = 'ここで選択したユーザに前回のログイン失敗情報を表示します。'; diff --git a/lang/ja/docs/coding.html b/lang/ja/docs/coding.html index 648f9456c06..9d2db0b355c 100644 --- a/lang/ja/docs/coding.html +++ b/lang/ja/docs/coding.html @@ -9,7 +9,7 @@

Moodleコーディングガイドライン

協力的なプロジェクトを堅牢にするためには、一貫性および安定性が必要です。

-

このガイドラインでは、Moodleコードが目指すゴールを提示するためにあります。 +

このガイドラインは、Moodleコードが目指すゴールを提示するためにあります。 間違いなく、いくつかの古いコードは少数の場所で目標基準に達していませんが、最終的に修正します。 全ての新しいコードは、これらの基準を可能な限り確実に順守してください。

一般ルール

@@ -19,9 +19,9 @@
  • 全てのテキストファイルは、Unixスタイルのテキストフォーマットを使用してください。 ( ほとんどのテキストエディタには、このオプションがあります。 )
  • 全てのphpタグは、<?php ?> のように「フルタグ」を使用してください ... <? ?> のように「ショートタグ」では無く。
  • 全ての著作権情報は保持してください。必要であれば、あなた独自の情報を追加することができます。
    • -
  • 各ファイルには、config.phpをインクルードしてください。
    • +
  • 各ファイルでは、config.phpをインクルードしてください。
  • 各ファイルでは、require_login() および isadmin()、isteacher()、iscreator() または isstudent() を使用してユーザが正しく認証されているか確認してください。
    • -
  • データベースへのアクセスは、可能な場合は常に関数 lib/datalib.php を使用してください - この関数により幅広いデータベースの互換性を実現します。この関数を使用することによりほとんどのことが実現できることに気付くでしょう。SQLコードを書く必要がある場合、次のことを確認してください: クロスプラットフォームであること、あなたのコードが特定の関数 ( 通常、lib.phpファイル ) に限定されていること、明確に注釈がなされていること。
    • +
  • データベースへのアクセスは、可能な場合は常に関数 lib/datalib.php を使用してください - この関数により幅広いデータベースの互換性を実現します。この関数を使用することにより、ほとんどのことが実現できることに気付くでしょう。SQLコードを書く必要がある場合、次のことを確認してください: クロスプラットフォームであること、あなたのコードが特定の関数 ( 通常、lib.phpファイル ) に限定されていること、明確に注釈がなされていること。
  • $CFG、$SESSION、$THEME および $USER のような標準的なもの以外、グローバル変数を作成または使用しないでください。
  • 全ての変数は使用する前に初期化するか、少なくとも isset() または empty() を使用して存在チェックを行ってください。
  • 全てのストリングは翻訳できるようにしてください - 「lang/en」内のファイルに新しい簡潔な英語の小文字でテキストを作成して、あなたのコードから get_string() または print_string() を使用して取り出してください。
    • @@ -33,12 +33,12 @@ -
  • ブラウザから ( GET または POST 経由で ) 入ってくるデータは、(PHPの設定に関わらず ) 安全にデータベースにインサートできるよう、自動的に magic_quotes が適用されます。他の全ての生データ ( ファイルまたはデータベース ) は、データベースにインサートする前に addslashes() でエスケープしてください。
    • +
  • ブラウザから ( GET または POST 経由で ) 入ってくるデータは、( PHPの設定に関わらず ) 安全にデータベースにインサートできるよう、自動的に magic_quotes が適用されます。他の全ての生データ ( ファイルまたはデータベース ) は、データベースにインサートする前に addslashes() でエスケープしてください。
  • 重要: Moodle内の全てのテキスト、特にユーザによって入力されるものは format_text() 関数を使用してプリントしてください。これによりテキストは、正確にフィルタおよびクリーニングされます。

    •  

    コーディングスタイル

    -

    他のスタイルを使用してきた場合、あなたのスタイルを変更することは少々面倒なことであると私は理解しています。しかし、後で人々が雑多なスタイルが使用されたMoodleコードの意味を理解する面倒さと、この面倒さのバランスを取る必要があります。人々が使用するスタイルには、明らかに良い部分もありますが、現在のスタイルはこれですので、どうか従ってください。

    +

    他のスタイルを使用してきた場合、あなたのスタイルを変更することは少々面倒なことであると私は理解しています。しかし、後で人々が雑多なスタイルが使用されたMoodleコードの意味を理解する面倒さと、この面倒さのバランスを取る必要があります。人々が使用するスタイルには、明らかに良い部分もありますが、現在のスタイルはこのスタイルですので、どうか従ってください。

    1. インデント は連続した4つのスペースにしてください。タブは使用しないでください。
    2. 変数名 は常に読みやすく、意味のある英語小文字にしてください。本当に1語以上の単語が必要な場合、単語を連結して可能な限り短くしてください。配列オブジェクト名には、複数形を使用してください。 @@ -51,12 +51,12 @@ 悪い: $aReallyLongVariableNameWithoutAGoodReason
      悪い: $error_string

      3. -
    3. 定数 は常に大文字を使用して、常にモジュール名で始めてください。単語は、アンダースコア ( _ ) で別けてください。 +
    4. 定数 は常に大文字を使用して、常にモジュール名で始めてください。単語はアンダースコア ( _ ) で別けてください。

      define("FORUM_MODE_FLATOLDEST", 1);

    5. 関数名 は単純な英語の小文字の単語を使用して、モジュール間のコンフリクトを避けるため、モジュール名で始めてください。 - 単語は、アンダースコア ( _ ) で別けてください。可能でしたら、パラメータは常に適切なデフォルト値を持つようにしてください。 + 単語はアンダースコア ( _ ) で別けてください。可能でしたら、パラメータは常に適切なデフォルト値を持つようにしてください。 関数名および続く ( 大括弧 ) の間にはスペースを入れないことに注意してください。

      function forum_set_display_mode($mode=0) @@ -162,8 +162,7 @@

      データベース構造

      1. 全てのテーブルは、プライマリインデックスとして auto-incrementing id フィールド ( INT10 ) を持つ必要があります。
        2. -
      2. 各モジュールのインスタンスを含むメインテーブルは、モジュールと同じ名前を持ち ( 例 widget )、次の最小限のフィールドを - 含む必要があります: +
      3. 各モジュールのインスタンスを含むメインテーブルは、モジュールと同じ名称を持ち ( 例 widget )、次の最小限のフィールドを含む必要があります:
        • id - 上記で説明
        • course - 各インスタンスが属するコースID
          • @@ -173,7 +172,7 @@
        • モジュールと関連する他のテーブルで「things」に関する情報を含むものは widget_things という名称を付けてください ( 複数形に注意してください )。
        • カラムの名称は、変数名と同じルールに従って簡単かつ短くつけてください。
        • 可能であれば、他のテーブルのidフィールドへの参照を含むカラム ( 例 widget ) は、widgetidと呼ばれるべきです。( この仕様は、やや新しいもので、他のいくつかの古いテーブルには適用されていないことに注意してください。)
          • -
        • 論理値 ( Boolean ) フィールドは、必要に応じて後で値を拡張できるように、0または1を含む整数フィールド ( 例 INT4 ) を使用してください。
          • +
        • 論理値 ( Boolean ) フィールドは、必要に応じて後で値を拡張できるよう、0または1を含む整数フィールド ( 例 INT4 ) を使用してください。
        • ほとんどのフィールドは、PHP time() 関数から現在のタイムスタンプで更新される timemodified フィールド ( INT10 ) を持つ必要があります。

       

      @@ -186,17 +185,17 @@
    6. 気をつけて data_submitted() を使用してください。データは使用される前に、更にきれいにする必要があります。
    7. $_GET、$_POST または $_REQUEST を使用しないでください。必要に応じて、適切な required_param() または optional_param() を使用してください。
    8. if (isset($_GET['something'])) のようなものを使用して動作をチェックしないでください。例えば $something = optional_param( 'something',-1,PARAM_INT ) を使用して、適切な値の幅に入っているかテストしてください。例 if ($something>=0) {...
      9. -
    9. 簡単に探すことができるように、可能な限り全ての required_param()、optional_param() および他の変数を各ファイルの最初に初期化してください。
      10. +
    10. 簡単に探すことができるよう、可能な限り全ての required_param()、optional_param() および他の変数を各ファイルの最初で初期化してください。
    11. フォーム処理ルーチンをアタックから保護するために「sesskey」メカニズムを使用してください。基本的な使用例: フォームが生成される時に、 include <input type="hidden" name="sesskey" value="<?php echo sesskey(); ?>" /> と使用します。フォームの処理を行う時は、 if (!confirm_sesskey()) {error('Bad Session Key');} でチェックしてください。
      12. -
    12. required_param() または optional_param() の適切な使用により「きれいにされていない」場合は、全てのファイルは clean_filename() 関数を使用して「きれいにする」必要があります。
      13. +
    13. required_param() または optional_param() の適切な使用で「きれいにされていない」場合、全てのファイルは clean_filename() 関数を使用して「きれいにする」必要があります。
    14. データベースから読み込んだデータは、更新する前に addslashes() を適用してください。データオブジェクト全体は、addslashes_object() で一度に処理することができます。
      15. -
    15. 可能な限り、データベースに保存するデータは、GET data ( 例 URLラインからのデータ ) とは対照的な POST データ ( method="POST" によるフォームデータ ) を使用してください。
      16. +
    16. 可能な限り、データベースに保存するデータは、GETデータ ( 例 URLラインからのデータ ) とは対照的な POSTデータ ( method="POST" によるフォームデータ ) を使用してください。
    17. 避けることができるなら $_SERVER からのデータを使用しないでください。これは移植性に問題があります。
      18. -
    18. 他で行っていない場合は、データベースに書き込む全てのデータを適切なデータタイプのPARAM_XXXXを使用して clean_param() 関数に通してください。
      19. +
    19. 他で行っていない場合、データベースに書き込む全てのデータを適切なデータタイプのPARAM_XXXXを使用して clean_param() 関数に通してください。
    20. あなたがカスタムSQLコードを記述する場合、間違いなく正しいことを確認してください。特に値の周囲のクォート漏れに気をつけてください。SQLインジェクションの脆弱性 ( exploit ) となる可能性があります。
    21. 全てのファイルで使用される全てのデータ ( 特にデータベースに書き込む部分) をチェックしてください。他でチェックされることを期待したり、信頼しないでください。
      22. -
    22. インクルードされるコードのブロックは、明確なPHP構造を含むべきです ( 例 クラス宣言、関数定義等 ) - 連続したコードのブロックは、初期化無しの変数の使用を進めてしまいます。
      23. +
    23. インクルードされるコードのブロックは、明確なPHP構造を含むべきです ( 例 クラス宣言、関数定義等 ) - 連続したコードのブロックは、初期化無しの変数使用を奨励してしまいます。

    Moodleドキュメンテーション

    diff --git a/lang/ja_utf8/admin.php b/lang/ja_utf8/admin.php index 8158dabb06d..a7fe0173650 100644 --- a/lang/ja_utf8/admin.php +++ b/lang/ja_utf8/admin.php @@ -30,7 +30,7 @@ $string['configdbsessions'] = '荐絎Yes翫憜 $string['configdebug'] = '荐絎Yes翫PHPerror_reporting紜紊茘茵腓冴障肴帥箴水荐絎с'; $string['configdefaultallowedmodules'] = '筝篏眼蕁潟若鴻篏翫с≪吾ャ若荐怨障?'; $string['configdefaultrequestedcategory'] = '鴻潟若鴻茯荐若翫潟若鴻荐臀眼с'; -$string['configdeleteunconfirmed'] = '＜若粋翫ゃ若吟菴膈篁障腟篋緇ゃ粋≪潟ゃ障'; +$string['configdeleteunconfirmed'] = '＜若粋翫ゃ若吟菴膈篁障腟篋緇ゃ粋≪潟ゃ障'; $string['configdenyemailaddresses'] = '劫＜ゃ潟違＜若≪鴻翫罨鴻若鴻у阪ｃュ篁＜ゃ潟茯障箴 hotmail.com yahoo.co.uk '; $string['configdigestmailtime'] = '＜若篆＜御若吟腮水絎鴻荀膣＜若罸ラ篆＜障с1ャт荀膣＜若篆＜荐絎障 ( 罨＜cronц┃絎緇絎茵障 )'; $string['configdisplayloginfailures'] = 'ч御若吟違ゃ喝け宴茵腓冴障'; diff --git a/lang/ja_utf8/docs/coding.html b/lang/ja_utf8/docs/coding.html index 6c722122e60..7888a36d031 100644 --- a/lang/ja_utf8/docs/coding.html +++ b/lang/ja_utf8/docs/coding.html @@ -9,7 +9,7 @@

    Moodle潟若ｃ潟違ゃゃ

    吾с≪筝莢с喝絎с綽荀с

    -

    ゃゃ潟сMoodle潟若眼若腓冴障 +

    ゃゃ潟Moodle潟若眼若腓冴障 ゃゃ潟若絨違贋х罔堺障腟篆罩ｃ障 違潟若堺純腆阪絎

    筝若

    @@ -19,9 +19,9 @@
  • 鴻＜ゃUnix鴻帥ゃ鴻若篏睡 ( 祉鴻ｃ帥激с潟障 )
  • php帥違<?php ?> 帥違篏睡 ... <? ?> 激с若帥違с＜
  • 篏罔宴篆綽荀с違宴菴遵с障
    • -
  • ＜ゃconfig.phpゃ潟若
    • +
  • ＜ゃсconfig.phpゃ潟若
  • ＜ゃсrequire_login() isadmin()isteacher()iscreator() 障 isstudent() 篏睡若吟罩ｃ顄荐若腆肴
    • -
  • 若帥若鴻吾≪祉鴻純翫絽吾∽ lib/datalib.php 篏睡 - ∽違綛綺若帥若鴻篋с絎憗障∽違篏睡祉絎憗с羂篁сSQL潟若吾鏆荀翫罨＜腆肴: 鴻若с潟若劫∽ ( 絽吾lib.php＜ゃ ) 絎腆冴羈
    • +
  • 若帥若鴻吾≪祉鴻純翫絽吾∽ lib/datalib.php 篏睡 - ∽違綛綺若帥若鴻篋с絎憗障∽違篏睡祉絎憗с羂篁сSQL潟若吾鏆荀翫罨＜腆肴: 鴻若с潟若劫∽ ( 絽吾lib.php＜ゃ ) 絎腆冴羈
  • $CFG$SESSION$THEME $USER 罔羣篁ュ違若紊違篏障篏睡с
  • 紊違篏睡絨 isset() 障 empty() 篏睡絖с茵ｃ
  • 鴻潟違膺肢┳с - lang/en＜ゃ違膂≧沿絨絖с鴻篏潟若 get_string() 障 print_string() 篏睡冴
    • @@ -33,12 +33,12 @@ -
  • 吟 ( GET 障 POST 腟宴 ) ャｃ若帥(PHP荐絎≪ ) 絎若帥若鴻ゃ潟泣若с magic_quotes 障篁若 ( ＜ゃ障若帥若 ) 若帥若鴻ゃ潟泣若 addslashes() с鴻宴若
    • +
  • 吟 ( GET 障 POST 腟宴 ) ャｃ若帥( PHP荐絎≪ ) 絎若帥若鴻ゃ潟泣若с magic_quotes 障篁若 ( ＜ゃ障若帥若 ) 若帥若鴻ゃ潟泣若 addslashes() с鴻宴若
  • 荀: Moodle鴻鴻若吟ｃュ format_text() ∽違篏睡潟鴻罩ｇ∈ｃ帥潟若潟違障

    •  

    潟若ｃ潟違鴻帥ゃ

    -

    篁鴻帥ゃ篏睡翫鴻帥ゃ紊眼絨√с腱茹ｃ障緇т査紊鴻帥ゃ篏睡Moodle潟若潟茹ｃ√√潟鴻綽荀障篋冴篏睡鴻帥ゃ障憜鴻帥ゃсс緇ｃ

    +

    篁鴻帥ゃ篏睡翫鴻帥ゃ紊眼絨√с腱茹ｃ障緇т査紊鴻帥ゃ篏睡Moodle潟若潟茹ｃ√√潟鴻綽荀障篋冴篏睡鴻帥ゃ障憜鴻帥ゃ鴻帥ゃсс緇ｃ

    1. ゃ潟潟 ｇ4ゃ鴻若鴻帥篏睡с
    2. 紊医 絽吾茯帥潟沿絨絖綵1茯篁ヤ茯綽荀翫茯ｇ純吾с茲医就篏睡 @@ -51,12 +51,12 @@ : $aReallyLongVariableNameWithoutAGoodReason
      : $error_string

      3. -
    3. 絎 絽吾紊ф絖篏睡絽吾≪吾ャ若у茯≪潟若鴻潟 ( _ ) уャ +
    4. 絎 絽吾紊ф絖篏睡絽吾≪吾ャ若у茯≪潟若鴻潟 ( _ ) уャ

      define("FORUM_MODE_FLATOLDEST", 1);

    5. ∽医 膣沿絨絖茯篏睡≪吾ャ若潟潟帥≪吾ャ若у - 茯≪潟若鴻潟 ( _ ) уャ純с＜若帥絽吾ゃゃ + 茯≪潟若鴻潟 ( _ ) уャ純с＜若帥絽吾ゃゃ ∽医括 ( 紊ф綣 ) 鴻若鴻ャ羈

      function forum_set_display_mode($mode=0) @@ -162,8 +162,7 @@

      若帥若号

      1. 若ゃゃ潟鴻 auto-incrementing id ｃ若 ( INT10 ) ゅ荀障
        2. -
      2. ≪吾ャ若ゃ潟鴻帥潟鴻＜ゃ潟若≪吾ャ若 ( 箴 widget )罨＜絨ｃ若 - 綽荀障: +
      3. ≪吾ャ若ゃ潟鴻帥潟鴻＜ゃ潟若≪吾ャ若腱違 ( 箴 widget )罨＜絨ｃ若綽荀障:
        • id - 筝荐ц
        • course - ゃ潟鴻帥潟鴻絮潟若ID
          • @@ -173,7 +172,7 @@
        • ≪吾ャ若∫ｃ篁若сthings≪宴 widget_things 腱違篁 ( 茲医就羈 )
        • 腱違紊医若緇ｃ膂≦ょゃ
        • 純с違篁若idｃ若吾с ( 箴 widget ) widgetid若違鴻с( 篁罕違с篁ゃゃ若羈)
          • -
        • 茫 ( Boolean ) ｃ若綽荀綽緇уゃ≦宍с0障1贋違ｃ若 ( 箴 INT4 ) 篏睡
          • +
        • 茫 ( Boolean ) ｃ若綽荀綽緇уゃ≦宍с0障1贋違ｃ若 ( 箴 INT4 ) 篏睡
        • 祉ｃ若PHP time() ∽違憜帥ゃ鴻帥潟ф贋違 timemodified ｃ若 ( INT10 ) ゅ荀障

       

      @@ -186,17 +185,17 @@
    6. 羂ゃ data_submitted() 篏睡若帥篏睡眼綽荀障
    7. $_GET$_POST 障 $_REQUEST 篏睡с綽荀綽 required_param() 障 optional_param() 篏睡
    8. if (isset($_GET['something'])) 篏睡篏сс箴 $something = optional_param( 'something',-1,PARAM_INT ) 篏睡ゃ綛ャｃ鴻箴 if ($something>=0) {...
      9. -
    9. 膂≦｢с純 required_param()optional_param() 割紊違＜ゃ
      10. +
    10. 膂≦｢с純 required_param()optional_param() 割紊違＜ゃу
    11. 若若潟≪帥篆茘激sesskey＜冴篏睡堺篏睡箴: 若 include <input type="hidden" name="sesskey" value="<?php echo sesskey(); ?>" /> 篏睡障若茵 if (!confirm_sesskey()) {error('Bad Session Key');} сс
      12. -
    12. required_param() 障 optional_param() 篏睡翫＜ゃ clean_filename() ∽違篏睡綽荀障
      13. +
    13. required_param() 障 optional_param() 篏睡с翫＜ゃ clean_filename() ∽違篏睡綽荀障
    14. 若帥若鴻茯粋昭若帥贋違 addslashes() 若帥吾с篏addslashes_object() т綺с障
      15. -
    15. 純若帥若鴻篆絖若帥GET data ( 箴 URLゃ潟若 ) 絲丞х POST 若 ( method="POST" 若若 ) 篏睡
      16. +
    16. 純若帥若鴻篆絖若帥GET若 ( 箴 URLゃ潟若 ) 絲丞х POST若 ( method="POST" 若若 ) 篏睡
    17. 帥с $_SERVER 若帥篏睡с腱紙с馹障
      18. -
    18. 篁цｃ翫若帥若鴻吾莨若若帥若帥帥ゃPARAM_XXXX篏睡 clean_param() ∽違
      19. +
    19. 篁цｃ翫若帥若鴻吾莨若若帥若帥帥ゃPARAM_XXXX篏睡 clean_param() ∽違
    20. 鴻帥SQL潟若荐菴違翫閫ｃ腆肴鴻ゃ蚊若羲羂ゃSQLゃ潟吾с激с潟綣掩 ( exploit ) 醇с障
    21. ＜ゃт戎若 ( 鴻若帥若鴻吾莨若) с篁сс緇篆♂若с
      22. -
    22. ゃ潟若潟若腆冴PHP罕鴻с ( 箴 劫ｈ∽医臂膈 ) - ｇ潟若＜紊違篏睡蚊障障
      23. +
    23. ゃ潟若潟若腆冴PHP罕鴻с ( 箴 劫ｈ∽医臂膈 ) - ｇ潟若＜紊遺戎絅宴障障

    Moodleャ＜潟若激с