Jumi 2.1ガイド
我々は、導入している Jumi Joomlaの2.1ベータ版! 1.5 ここ。このバージョンでは、非常に多くの変更があります!
ときに最終的なリリースに2.1ベータの変更および2.0は、私たちは標準的なJumiのマニュアルにこの文書を組み込む予定償却マークされます。
イントロ
Jumiは、構文が異なるものに(3年後に)変更されているプラグインです。しかし、あなたが2.1リリースで以前のすべてのカスタムコードや機能を使用することができます(新しいものを使用)、この構文には後方互換性はありません。
に変化があるというわけではありません。構文だけをプラグインです。変更は、別の場所です。ようにしてください、慎重にドキュメントを参照してください。
誰も新しいバージョンを試して熱望しているか、クイック&ダーティは、構文の変更をプラグインですここでは"すべてのもの"を読むことを憎む人の場合:
オールドJumi構文をプラグイン
{jumi [stored_code_sourceの] [値arg1] [arg2の] ... [ユーザー定義関数をの]}
新しいJumi構文をプラグイン
{jumi stored_code_source} written_code {/ jumi}
どのようにJumi 2.1構文への移行を作るには?我々は、下に説明します。しかし、最初のもの最初の。
いくつかの全体的なJumi拡張子の説明を見てみましょうその後、我々はアップグレードする方法と、インストールが続行されます。最後には"すべてのもの"について十分な知識を取得します。
Jumiの拡張機能のセット
Jumi 2.1は、いくつかの相互依存の拡張機能で構成されています:
- Jumiシステムでは、プラグイン (完全に書き換え!)
Joomlaのにいくつかのリソースからカスタムコードを含めることができます!記事、コンテンツおよびカテゴリについて説明しています。
それはJumiコンポーネントとJumiモジュールのJumiルートを設定します。コードはJoomlaのPDF版で処理されます!コンテンツやRSSから取り除かれます。 - Jumi編集xtd (新)
Joomlaのです!エディタコーディング/ Joomlaのに彼らの直接的包含するためのスクリプトをデコードすることができますボタンを!コンテンツとJumiシステムによってさらなる処理はプラグインです。 - Jumiコンポーネント (+ Jumiルートの使用状況を共有)
カスタムJoomlaが作成されます!ページ(いわゆるJumiアプリケーションと呼ばれる)を含むカスタムコード。 - Jumi SEFのルータ
システムはスキップJumiコンポーネントをサポートしているプラグイン:それはそれとJumiアプリケーションの直接のアクセスを可能にするのエイリアスを(http://www.mysite.com/hello-jumiなど)。 - Jumiモジュール (+デバッグモードでは、+共有Jumiルート使用)
Joomlaのにいくつかのリソースからカスタムコードを含めることができます簡単なモジュールが!モジュールの位置。 - 言語
Jumiルータ以外は簡単に翻訳のすべてのJumiの機能拡張のための言語ファイルが存在するプラグインです。
Jumi 2.1の要件
次に以下の何もJoomlaの! 1.5.8が必要です。
アップグレード以前のバージョンから
我々は完全に以前のすべてのJumi拡張機能をアンインストールして、Jumi 2.1パッケージをインストールすることをお勧めします。次の点を考慮:
あなたの古いJumiコンポーネントを使用する場合は、 データベーステーブル して、新しいJumi 2.1で、使用しているデータベースのツール(例えば、phpMyAdminが)で最初にそれをバックアップします。新しいパッケージのインストールが終了したら、元のJumiコンポーネントのデータベーステーブルを復元します。
古いJumi 構文プラグイン 新しいにより処理されないプラグイン。あなたはすべて、古い構文インスタンスをプラグインを書き換える必要があります。我々は非常にそれはあなたをもたらす不便をおかけして申し訳ありません。一方、それはあなたに多くの可能性、より高いセキュリティと柔軟性をもたらすでしょう。何のための何か。
また、覚えているすべてのJumiこと モジュール アンインストールの処理中に破棄されます。私たちは、少なくともすべてのJumiモジュールの内容をメモすることをお薦めします。
Jumi 2.1のインストール
標準的なJoomlaのようにパックをインストールします!拡張子が付きます。すべてのJumi拡張子は、このワンクリックで処理中にインストールされています。すべてのJumiプラグインは、あまりにも"有効"に設定されている。
Jumi 2.1ではなくデモのメインメニューがある"ハローJumi!"それはJumi 2.0にあったようにフロントエンドで表示されるアイテム。ユーザーの皆様の中には、デモとしても、それを利用しています。あなたがそれをしたい場合は、それが目に見える手動で行う必要があります:"こんにちは!Jumi"をバックエンドに移動し、プリインストールされているメニュー項目を公開がある。
次のステップ
使用Jumiコンポーネント、モジュールとルータは、以前のリリースまたはマニュアルのこのcheatsheetから推定することができます。
Jumiは、詳細な説明を必要とするプラグインです。それは別のツールを使用しているので:Jumi編集xtd(ボタン)の方法でエンコード/デコードカスタムスクリプトは、彼らはJoomlaから削除されていないことプラグイン!とJumiによって処理されますプラグインです。
私たちは説明する資料の残りの部分では:
- どのようにJoomlaのにコードを書いて! Jumiコーダ(編集xtdプラグインをJumiのコード名)との内容。
- どのようにJoomlaのでコードを編集する! Jumiコーダとの内容。
- 何歳Jumiは新しいものに構文をプラグインに転送します。
- Jumiは、セキュリティおよびその他の発言をプラグインです。
Jumiコーダを使用して
まあ、ビデオが最初に参照してください。我々は、後に説明します。
それでは、どのように動作するか?
あなたはあなたがJoomlaにカスタムスクリプトが含まれているときに知っている!記事コードは、最高の状態で、または取り除かれるHTMLエンティティにエンコードされます。
そして、ここJumiコーダーています。それはJoomlaのような方法でスクリプトをエンコード!そのエディタは、コードが認識されません。しかしJumiはJumi構文を、すべてJumiタグの間に認識プラグインです。
{jumi stored_code_source}これは、タグの間にスペースはあなたの書かれたコード{/ jumi}です
デコードは、評価します。シンプルで、そうではありませんか?
Jumiコーダは、超小型MCEは、JCEプロバイダとのFCKエディタが正常にエディタをnowysiwygでテストされています。どのような素晴らしいあなたが望むようには、エディタの編集を切り替えることができますということです。 Jumi Coderは、それらには依存しません。
だからもう一度、どのようにJumiコーダを介して記事にコードが含まれていますか?記事を読むと同時に画像を参照してください:
- (またはいくつかのソースからコピー)コードエディタの領域にスクリプトを記述します。
- あなたは、od NowysiwygのWYSIWYGエディタを使用している場合実現。それに応じて選択してエンコードを指定します。
- を押してエンコード。
- スクリプトは、エンコードされており、エンコードされたコード領域にエンコードされた結果を取得します。 (か、またはミスを犯していた場合は、別のエディタの種類にスクリプトをエンコードしただけでデコードを繰り返しキーを押します)。
- は、エンコードされたコード領域に参照してくださいスクリプトを選択してクリップボード(Ctrl + Cキー)にそれをコピーしてJoomlaにそれを(CTRL + V)を貼り付けて!と中Jumiタグの間。
どのようにJoomlaのに既にされているスクリプトを編集するには:非常にあなたがさんは、別のビデオを見てみましょう理解を確認するには!とJumiコーダ。
我々は、それが十分明確であると思います。
だからJoomlaのにスクリプトを埋め込むためのJumi Coderを使用する!その編集のために。
Jumiコーダーは、非Joomlaのにスクリプトコードを埋め込むために使用することができます! (ブロガーのような)もブログ。コードは処理されませんコードのように表示されます。
既知の問題:スクリプトの場合は"きれい"フォーマット(複数行、タブなど)を エディタをnowysiwyg この書式を壊す(ユーザビリティの失われたこと - それが動作します)。私は(MarHaj)どのように対処するのか分からない。
WYSIWYGエディタで素敵な書式設定は保持されます。
これは、スクリプト自体は実行されません(インストールされている有効な場合)Jumiせずにプラグインのことは明らかだ! Jumiプラグインが最初にそれをデコードする必要があります。注意:JumiコーダとJumiは双子プラグイン!
構文の概要
一般的なJumi 2.1は構文は次のとおりですプラグイン
{jumi stored_code_source} written_code {/ jumi}
ここで、
- stored_code_source ファイルには、(PHPは、CSSのは、jsのは、txtというHTML、...)パス名が代わりに含まれるようにするの構文には、idとJumiコンポーネントの項目の(アスタリスクを進めて)プラグイン
- written_code いくつかのコードです。 HTMLやPHPは、jsのは、テキストだけをオト。それがPHPの開始タグと終了タグにラップされる必要がありますPHPコードしてください。
例
例1:ちょうどphpファイルが含まれています
{/ jumi} {jumiは/ jumi_demo.php / jumi /システムをプラグイン}
例2:Jumiコンポーネントのデータベーステーブルからの最初のレコードを含む
{jumi * 1} {/ jumi}
例では、3:れJumiコンポーネントdatabesテーブルから最初のレコードが含まれています 前 (!)によって書かれたスクリプトを実行します。
{jumi * 1}未満は?PHPのエコー'こんにちはOの\'ハラ';!> {/ jumi}
処理written_codeの優先順位 - > stored_code_sourceは、2つの理由は持っている:
- それは、Jumi 2.1構文(私たちは、後でどのように正確に表示されます)とJumiの引数を使用することを事前に2.1 Jumiのphpファイルを利用することができます
- 彼らは、まったく同じ処理の優先順位を持っている:それは、他のJumi拡張機能(コンポーネント、モジュール)と互換性があります。
記述されたスクリプト内の複数の行
1つの行にjumiタグの間に書かれたスクリプトを記述する必要はありません。複数の行は許可されています。 (そして、スクリプトの種類の組み合わせだけでなく、使用されます)。たとえば:
{jumi * 1}
する<?PHPの
ハラを'は、O \こんにちは'エコー';
?>
<DIV>の
<scriptのlanguage="JavaScript"のtype="text/javascript">
("?あなたの好みのドリンク<br />"など)ォ;
機能のおかげで(){
window.alertは、("ありがとう!")}
未満/スクリプト>
の<form>
<selectのname="qq">
<オプション>水未満/オプション>
<オプション>ミルク未満/オプション>
<オプション>ベアー未満/オプション>
<オプション>その他の未満/オプション>
未満/選択>
<input type="button" value="show" onClick="thanks()">
未満/フォーム>
<DIV>の
{/ jumi}
Jumiと今のを聞かせ契約は、下位互換性構文プラグイン。
オールドJumiは、構文の移行をプラグイン
古い - 中古2.1 Jumiは - を利用したプラグインと呼ばれる Jumi引数 概念。これは、含まれているファイルに引数を(いくつかの値)を渡すたりJumiコンポーネントのデータベースレコードの項目が含まれています。
その場合、構文はこのような例として、されました:
{jumi [myfile.php] [江戸] [888]}
引数の値(この場合は番号をテキストに"江戸"と番号888)$ jumi []配列を介してPHPのsript(myfile.php)でアクセスされました。このように:
する<?PHPの
$はjumi [0] $ [1] jumiエコー'@ gmail.comさんの';
?>
古いPHPスクリプト場合は、$ jumi []配列は、それらをゴミ箱に移動する必要はありません使用しています。ただwritten_codeセクションで$ jumi配列を定義:
{jumi myfile.php}未満のPHP $ jumi =配列('江戸'、888);??> {/ jumi}
そして、それがwritten_codeが格納されているコードの前に処理される理由です。
我々はそれがクリアされている、これは簡単な構文をプラグイン2.1に、古いスクリプトを移行できるようになると期待。
あなたが最初からスクリプトを書く場合は、written_codeで定義することができます 任意の 変数はあなたがstored_code_sourceで使用することができます。たとえば、
{jumi myfile.php}
する<?PHPの
します$ name ='江戸';
します$ number = 888;
?>
{/ jumi}
注意:あなたは、関数やクラスの外で定義した変数はグローバル変数になります。これは、両方の良い面と悪い面があります。
変数は、どこからでもアクセス可能ですので、良いです。これはJoomlaの別の場所に(別の開発者)が定義されて、同じ名前の変数を使用してinterractすることができますので、悪いです!ページを表示します。
つまり、あなた自身のグローバル変数を使用している場合は、それらをではなく、風変わりな名前提供します。
新しいJumiは、セキュリティ上の問題をプラグイン
場合はJoomlaを使用している!コンテンツに貢献できる多くの人々があることを意味オープンな環境として、セキュリティの問題は、その値を持っている。
のは一瞬悪影響を与えたり、自分の利益を望んでいる彼または彼女は男があると仮定します。男は自由にあなたのサイトにスクリプトが含まれて有効になっている場合、スクリプトは実際にあなたのウェブサイトを完全にコントロールから男を防ぐことができなくなります処理されます。あまりenoyableアイデアは、ありえない'は?
古いJumiは、ファイルまたはデータベースからだけでスクリプトが含まれています。侵入者が(そして、彼/彼女は場所を知っている必要があります)あなたのサイトにされているものだけを使用することができます。しかし、今、直接スクリプト含めることは可能ですが?それは別のケーキです!
Joomlaの!開発者が導入している ブラックリストとホワイトリストJoomlaのコンセプトをフィルタリング! 1.5.8。あなたがたは、ブラックリストにあるか、またはされていない、特定の"モノ"を行ってから、ホワイトリストにそれらを防ぐことができます。
Jumi 2.1が使用このリストプラグインです。場合 記事の著者 (または所属するグループ)ブラックリストにあるか、またはホワイトリストにないしJumiは、プラグイン 処理されません コード(直接書き込まれるか含まれているファイルまたはデータベースから)とコード は表示されません フロントエンドインチ
Joomlaの!記事からコードが出itselfsストリップ。エディタボタンがJoomlaのスクリプトをエンコードが含まれるプラグインとしてJumiコーダーは誰にも利用可能です!消去されません。 Thyeコードがあるでしょう。しかし、処理さない!それはJumiがアンインストールされたプラグイン後も処理されません - スクリプトは、私たちが繰り返してエンコードされます。
だからあなたのホワイトリストが/ブラックリストはaffraidてはいけない、正しく設定されている。ただ注意してください。
パラメータ"Jumiデフォルトの絶対パス名は、"あなたは、以前のリリースからそれを知っているようにはまだそこにあります。 Jumiルート:今私たちはそのためではなく、別の名前を使用しています。
Jumiルートパラメータは、それらへのフルパスを何度も繰り返し書くwithoyt簡単にスクリプトファイルにアクセスすることができます。あなたがJoomla外部にスクリプトファイルを配置することができます!あまりにもルートディレクトリを指定します。
Jumiルートは、以前はそれぞれ独立してJumi拡張子によって設定されています。今、あなたはそれを設定することができるだけ一つの場所があります:Jumiはプラグインです。セットアップは、すべてのJumi拡張子に対してのみ有効です。
だから今のところすべてを見る
我々は、開発者は、江戸時代、私は(MarHaj)、Jumiユーザーのフィードバックを認識します。 Jumi自体、またはこのドキュメントについて。何か足りない?何か不明?何かが期待どおりに動作しないのですか?
事前にお時間をいただきありがとうございます!

