Geeklog TinyMCEプラグイン

作者
mystral-kk <geeklog AT mystral-kk DOT net>
バージョン
0.4.6 (ベータ版)、TinyMCEのバージョンは3.3。
公開日
2010-04-13
ライセンス
GPLv2以降
必要条件
Geeklog-1.6.0以降

概要

Geeklog TinyMCEプラグインは、JavaScriptを使用した有名なWYSIWYGエディタであるTinyMCEをプラグインとして実装しています。使用する際には、WebブラウザでJavaScriptを有効にしている必要があります。

TOPへ戻る

インストール

以下の説明で、

を表しています。

  1. 管理者メニューのデータベースやphpMyAdminを使用して、データベースのバックアップを取ります。TinyMCEプラグインはデータベースにデータを追加します。
  2. プラグインのアーカイブファイルを <geeklog_dir>/plugins フォルダ内に展開（解凍）します。plugins フォルダ内に tinymce というフォルダができます。
  3. <public_html>/ フォルダ内にtinymceという名前のフォルダを、また、<admin>/plugins/ フォルダ内にも tinymceという名前のフォルダを作成します。
  4. <geeklog_dir>/plugins/tinymce/ フォルダに移動し、public_hrmlフォルダの内容を先ほど作成した<public_html>/tinymceフォルダ内にコピーします。また、adminフォルダの内容を<admin>/plugins/tinymce/フォルダ内にコピーします。
  5. 管理者としてサイトにログインし、プラグインエディタで"TinyMCE"をクリックします。インストールに失敗した場合は、エラーログ(<geeklog_dir>/logs/error.log)を調べてください。
TOPへ戻る

使用法

1. 設定

Geeklogのグループごとに、TinyMCEのツールバーボタン、プラグインをカスタマイズできます。設定するには、管理者メニューのTinyMCEをクリックします。

2. プラグイン

プラグインの中には、HTMLタグと属性(属性がない場合もあります)を出力するものがあります(下記の表1をご覧ください)。これらのタグ(と属性)はGeeklog側で許可しておく必要があります。そのためには、管理者としてサイトにログインし、「コンフィギュレーション」->「その他」をクリックし、「HTMLフィルタ」の「ユーザHTML」や「管理者HTML」で追加します。たとえば、autoresizeプラグインを使用する場合、このプラグインはタグを出力しないので、HTMLタグを出力する必要はありません。しかし、emotionsプラグインを使用する場合は、imgタグを追加する必要があります。同様に、advhrプラグインを使用する場合は、hrタグとstyle属性を追加する必要があります。同様に、legacyoutputプラグインを使用する場合は、font、b、i、u、strikeタグを追加する必要があります。

メモ: contextmenu、inlinepopups、xhtmlxtrasプラグインは常に有効になっています。

表1 プラグインが出力するHTMLタグと属性
プラグイン名プラグインの動作出力されるHTMLタグと属性
advhr 拡張水平線を挿入する hr[style]
advimage 画像の挿入/編集 img
advlink リンクの挿入/編集 a[href]
advlist 番号付き/番号なしリスト ul, ol, li
autoresize エディタウィンドウのサイズを自動的に変更する (なし)
autosave 編集中の文書を自動的に保存する (なし)
bbcode bbcodeを挿入する (なし)
directionality 文字の方向(左から右、右から左)を設定する (なし)
emotions 顔文字を挿入する img
fullscreen フルスクリーン表示 (なし)
iespell スペルチェック(インターネットエクスプローラのみ) (なし)
insertdatetime 現在の日付/時刻を挿入する (なし)
layer レイヤーを挿入/編集する (なし)
legacyoutput 旧式のHTMLタグを入力する(非推奨) font, b, i, u, strike
media メディアを挿入/編集する img
nonbreaking 改行しないスペースを挿入する (なし)
noneditable 編集禁止領域を設定する (なし)
pagebreak 改ページを挿入する img
paste 貼り付け (なし)
preview プレビュー (なし)
print 印刷 (なし)
searchreplace 検索/置換 (なし)
spellchecker スペルチェック (なし)
style CSSスタイルの編集 (なし)
tabfocus タブフォーカス (なし)
table テーブルを挿入/編集する (なし)
template テンプレートを挿入する (なし)
tinybrowser TinyBrowser(ファイル表示)を有効にする img
visualchars 制御文字の表示/非表示 (なし)
wordcount 語数カウント (なし)
emojiau auの絵文字を入力する img
emojidocomo docomoの絵文字を入力する img
emojisoftbank SoftBankの絵文字を入力する img
TOPへ戻る

3. ツールバーのボタン

ツールバーのボタンの中には、HTMLタグと属性(属性がない場合もあります)を出力するものがあります(下記の表2をご覧ください)。これらのタグ(と属性)はGeeklog側で許可しておく必要があります。そのためには、管理者としてサイトにログインし、「コンフィギュレーション」->「その他」をクリックし、「HTMLフィルタ」の「ユーザHTML」や「管理者HTML」で追加します。たとえば、copyボタンを使用する場合は、HTMLタグを出力しないので、タグを追加する必要はありません。しかし、blockquoteボタンを使用するには、blockquoteタグを追加する必要があります。同様に、backcolorボタンを使用するには、spanタグとstyle属性を追加する必要があります。同様に、bullistボタンを使用するには、ulタグとliタグを追加する必要があります。

注意: 下記の表2からわかるように、文字を修飾するには<p>タグとstyle属性、及び、<span>タグとstyle属性を許可する必要があります。

プラグインのボタン名は、プラグインの名前と同じです。上記の表1をご覧ください。

表2 ツールバーのボタンが出力するHTMLタグと属性
ボタン名 ボタンの機能 ボタンが出力するHTMLタグと属性
anchorアンカーを挿入しますa[name]
backcolor背景色を設定しますspan[style]
blockquote引用(ブロッククォート)blockquote
bold太字strong
bullist数字なしリストul, li
charmap特殊文字を入力する(なし)
cleanupコード整形(なし)
codeHTMLソース編集(なし)
copyコピー(なし)
cut切り取り(なし)
fontselectフォント選択span[style]
fontsizeselectフォントサイズ選択span[style]
forecolor文字色設定span[style]
formatselectフォーマット設定(なし)
helpヘルプ表示(なし)
hr水平線を挿入するhr
image画像を挿入/編集するimg
indentインデントp[style]
italic斜体em
justifycenter中央揃えp[style]
justifyfull両端揃えp[style]
justifyleft左揃えp[style]
justifyright右揃えp[style]
linkリンクを挿入/編集するa[href]
numlist数字付きリストol,li
outdentインデント解除p[style]
paste貼り付け(なし)
redoやり直し(なし)
removeformatフォーマット解除(なし)
strikethrough取消線span[style]
styleselectCSSスタイル選択span[style]
sub下付き文字sub
sup上付き文字sup
underline下線span[style]
undo元に戻す(なし)
unlinkリンク解除a[href]
visualaidガイドラインと非表示項目の表示切替(なし)
TOPへ戻る

アンインストール

  1. 管理者としてサイトにログインし、「プラグイン」をクリックします。"TinyMCE"を削除すると、関連するデータがデータベースから自動的に削除します。
  2. インストール時に作成した3つのフォルダ(<geeklog-dir>/plugins/tinymce/、<public_html>/tinymce、<admin>/plugins/tinymce/)を削除します。
TOPへ戻る

更新履歴

日付(YYYY-MM-DD)バージョン説明
2010-04-130.4.6 [修正] 対象テキストエリアをCSS IDで指定したときに、ツールバーがきちんと表示されないバグを修正しました。
2010-03-170.4.5 [新規] TinyMCE-3.3を使用するようにしました。
[修正] Geeklogでは無用のfullpageプラグインをサポートしないようにしました。
2010-03-140.4.4 [修正] コンテキストメニューが無効になっていたバグを修正しました。
2010-03-130.4.3 [修正] バージョン0.4.1で修正したつもりになっていたバグを修正しました(今度こそ!)。
[新規] テンプレートファイルを作成/編集/削除するUIを管理者メニューに追加しました。
2010-03-110.4.2 [修正] バージョン0.4.1で修正したつもりになっていたバグを修正しました。
2010-03-110.4.1 [修正] 管理者メニューで新規コンフィギュレーションが一部おかしくなっていたバグを修正しました。
[修正] エディタウィンドウ内の表示に、Geeklog本体のCSSではなくプラグイン独自のCSS(公開領域/tinymce/js/editor.css)を使用するようにしました。
2010-03-100.4.0 [新規] ツールバーのボタンとプラグインがGeeklogで許可しているHTMLタグを完全に反映するようになりました。
[新規] プラグインを3つ(emojidocomo、emojiau、emojisoftbank)追加しました。docomo、au、ソフトバンクの携帯電話で使用されている絵文字を入力できます。アイデアをいただいたひろろんさんに感謝します。
2010-03-080.3.0 [新規] TinyMCEプラグインに同梱されているTinyBrowserプラグインを設定するコンフィギュレーションを追加しました。
2010-03-070.2.1 [新規] ENTERキーを押したときに、<p>タグを挿入するか（初期値）<br>タグを挿入するかを選べるようにオプションを追加しました。
[修正] ツールバーのボタンがはみ出さずにすべて表示されるようにしました。ご指摘いただいたひろろんさんに感謝します。
[修正] 静的ページでPHPを許可していないときにTinyMCEが有効にならないバグを修正しました。ご指摘いただいたひろろんさんに感謝します。
2010-03-060.2.0 [新規] 最初のベータ版です。コンフィギュレーションの「対象textarea」に「自動選択」というオプション（初期値）を追加しました。このオプションを選択すると、GeeklogのエディタでHTMLが有効なもの、つまり、記事/静的ページ/コメント/カレンダ/グループメール/ブロック編集時に、ドロップダウンリストで"HTML"を選択するかオプションで"HTML"にチェックを入れると、TinyMCEが自動的に読み込まれます。
[新規] TinyMCEプラグインをインストールするときに、FCKeditorとの競合を避けるため、コンフィギュレーションの「アドバンストエディタを使用する」を「いいえ」に変更するようにしました。もちろん、この場合でもTinyMCEは使用できます。
[修正] Geeklogがドキュメントルートのサブディレクトリにインストールされているとき、画像をきちんと扱えていなかったバグを修正しました。
2010-03-040.1.3 [修正] PHPを実行する静的ページを編集するときにTinyMCEを読み込まないようにしました。
2010-03-030.1.2 [修正] tinyBrowserプラグイン使用時、ユーザーがフォルダを操作する権限を持っていないときにエラーが発生するバグを修正しました。
2010-03-020.1.1 [新規] エディタウィンドウの高さと横幅をコンフィギュレーションで指定できるようにしました。ご指摘いただいたひろろんさんに感謝します。
[修正] tinyBrowserプラグインの一部の画面でCSSが効いていなかったバグを修正しました。ご指摘いただいたひろろんさんに感謝します。
2010-03-010.1.0 [新規] 初公開。TinyMCEのバージョンは3.3b2。

2010 © mystral-kk at mystral-kk.net