Home arrow Extensions arrow Joomla! CMS

9月
04
2008

エクステンションのパラメータでサポートされているタイプ : Joomla!1.5

diggに追加!

joomla15_custom_parameters Joomla!でエクステンションを作成するとき、必ず必要なのが、エクステンション名.xmlです。

この中でエクステンションの設定値などをタイプやデフォルト値で指定する「params」というものがあります。

さて、今回質問があったのであらためて見てみました。

<param name="名前" type="タイプ" default="初期値" label="ラベル(表示名)" description="説明" />

上記のようにパラメータを指定しますが、どのように使うのか。

  • 名前(name)について
    これは、$params->get('ここ');で取得する名前を指定します。
  • タイプ属性 ( type )について
    これにはいくつかデフォルトで指定できるものが用意されています。
    • calendar
      これは、カレンダーを表示させ、日付を指定させることができます。この時の日付フォーマットは、属性で format="%Y-%m-%d" などとparam内に書けばフォーマットを指定でいます。
      例:
      <param name="mydate" type="calendar" label="Select Date" format="%Y-%m-%d" default="" description="" />
    • category
      これは、カテゴリーのリストを表示してくれます。また、scope属性でsectionの範囲を指定することもできます。
      例:
      <param name="catid" type="category" label="Select Cat" scope="content" default="" description="" />
    • editors
      これは、エディタを選択するリストを表示します。
      例:
      <param name="editor" type="editors" label="Select Editor" default="" description="" />
    • filelist
      これはファイルリストを表示します。4つの属性値を指定できます。
      • directory
      • fitler
      • exclude
      • stripext
    • folderlist
      これはフォルダのリストを表示します。3つの属性値を指定できます。
      • directory
      • filter
      • exclude
    • helpsites
      これは、ヘルプサイトのリストを表示します。デフォルトでは、http://help.joomla.orgのみとなっています。
    • hidden
      これは、hiddenフォームを作成してくれます。ユーザーの入力はできません。
      ちなみにJBackupで使っています。
    • imagelist
      イメージリストを表示します。指定できる属性は、filterのみで以下のように指定します。
      filter='\.jpg$|\.gif$'
      と指定すれば、jpgとgifのみのリストとなります。
    • languages
      言語のリストを表示します。属性はclientです。指定できる値は、JPATH_以下の文字です。
    • list
      これは、一般的によく使われているので説明しません。
    • menu
      メニューのリストを表示してくれます。
    • menuitem
      メニューアイテムを表示してくれます。
    • password
      type属性がpasswordのフォームを表示してくます。
    • radio
      これは、一般的によく使われているので説明しません。
    • section
      セクションのリストを表示してくれます。属性はありません。また、マルチセレクトにはなりません。
      例:
      <param name="sectionid" type="section" label="Select Section" default="" description="" />
    • spacer
      これは、一般的によく使われているので説明しません。
      Tips:default属性に値を入れるとそれがボーダーの代わりに表示されます。
    • sql
      これは、自由にカスタマイズできるリストを作成してくれます。query属性にSQLクエリを入力すれば、その結果をリスト化してくれます。
    • text
      これは、一般的によく使われているので説明しません。
    • textarea
      これは、一般的によく使われているので説明しません。
    • timezones
      タイムゾーンのリストを表示してくれます。
    • usergroup
      ユーザーグループのリストを表示してくれます。
    • もっとカスタマイズしたフォームを作成したい場合
      Joomla!1.5では<paramsタグ内に次のように属性を追加することでオリジナルのelementファイルを呼び出させてオリジナルのフォームを表示させることができます。
      <params addpath="/components/com_jcontentplus/elements">
      このように指定することで指定されたパス内のtype属性で指定した名前のファイルをロードしてくれます。そして以下のようなクラス名を呼び出してくれます。
      例:type="myform"なら
      class JElementMyform extends JElement{ここに対応するメソッドを書く}
      このようにすることによってほとんど制限なくカスタマイズされたフォームを自由に作成することが可能です。
      ※JContentPlusでは多用していますので参照してみて下さい。
  • default値について
    これは、そのフォームの初期値です。はじめて表示した場合や、何も入力していない場合などにこの値が選択または、入力された状態で表示されます。
  • description値について
    マウスをフォームのタイトル部分にあてた時、表示されるTipに出力される説明です。

以上簡単に書いてみました。このように属性に指定することによって自動でフォームを作成してくれる機能がJoomla!1.0.xにももちろんありましたが、Joomla!1.5ではさらに拡張されているようです。私もすべてを使ってみたわけではありませんのであらためて便利さを感じました。

これだけ用意されているのでかなりコーディングも楽になりますね。

 

Related Articles

HTMLをこれで管理することにしよう :
新しいエクステンションのドキュメントを編集するときいつも以前に書いたものをコピーして作成していたりするのですが、これが結構不便なもので以前のドキュメントを見るためにブラウザで該当ページを開くか、同じ管...
News機能:Joomla!
Joomla!には便利な機能があってサイトのRSSを取得して表示する機能があります。ですが、そのまま表示させている方は少ないと思います。見栄えが悪いのじゃないかと・・・。 リクエストがあったのでRS...
ダウンロード数を比較してみると : Joomla!
エクステンションのダウンロード数を比較してみるとJoomla!1.0.xと1.5では、1.0.xが約半分か、それ以下といったところでしょうか。Joomla!1.5はかなり使っている方が増えてきているよ...
英語力
30問ある中学1年の英文法問題をやってみた。 結果、21問正解でした。欠けている単語を入力するだけなのですが、なんと情けない結果でしょう。これでよく英語のエクステンションなど作っていられますねぇ。  ...
SyntaxHighlighter : Windows Live Writer プラグイン
Windows Live WriterのプラグインSyntaxHightlighterを使うととても便利です。Joomla!にうちのSyntaxHighlighterプラグインをインストールしてお...
descriptionをブログ記事の表示順に変更してみた : Joomla!1.0.x
ページのソースを表示してdescription部分を見るとそのページで開いている最後(一番下)の記事のdescriptionが、最初に表示される。これは、Joomla!のヘッドタグに追加するメソッドが...
Ajax RSS Translation Reader Update!!
Ajax RSS Translation Reader モジュールをアップデートしました。 変更点 翻訳対応英語、ドイツ語のみでしたが、フランス語、ロシア語のYahoo! Pipesを追加しまし...
かっこよくエラーを吐こう : Joomla! 1.5
Joomla!1.5でエラーページをどうにかしたいと検索していたら、forum.joomla.orgに投稿を見かけたので・・・。 以下のように説明されていました。phpファイルをincludeと説明...
htaccessのサンプル
Joomlaのadministratorフォルダとxmlrpcフォルダに.htaccessでアクセス制限をかけましょう。 以下は、サンプル。※指定したIPアドレスなら認証をスルーします。ご注意を。 ...
80codeでのJoomla!
このサイトを置いている80codeサーバーでは通常のJoomla!のデフォルトの設定では正しく動きません。 異なる点 (私の場合だけのものもあるかもしれない。) htaccessは使...
日時の文字化け
mod WebLink Infoを公開しました : Joomla!1.5
MovableType XML-RPC プラグインをアップデートしました: Joomla! 1.5
セキュリティについてアナウンスされました : Joomla!1.5
Joomla! サイトのローカルコピーを作成
よりセキュアにJoomla!
一晩たったらもうアップデートしていたよ
Pinger! for Joomla!1.5のファイルを更新しています
時々サーバーに接続できないと言われる
Meta Tag Generatorを消す : Joomla! 1.5

C_square_trans.png Components
Joomla! Extensions
M_square_trans.png Modules
Joomla! Extensions
P_square_trans.png Plugins
Joomla! Extensions
Templates
Joomla! Extensions
a_delphi.gif Delphi for PHP
Delphi for PHP related

for Mobile