表組編集支援プラグイン

table_edit2.inc.php

進行状況を整理するために、仮公開いたします。

• 進行状況
• 仕様
  • define設定
  • オプション
  • サンプル
    • Ver1.3より title textarea form のオプションが新たに増えました。
  • 表計算機能
    • 関数 セル内で使用
  • CSV機能
    • CSV形式ファイルのインポート、エクスポート
• ダウンロード
  • 表組編集支援+表計算機能バージョン
  • 表組支援機能のみバージョン
• ちなみに
• コメント

進行状況

仕様

• 表の書き始めは通常の編集で次のように書いて頂ければtable_edit2を使うことができます。

  #table_edit2{{
  |||
  }}

  • 但し、ページに認証制限や凍結が行われている場合は編集アイコンが出てきません。
  • 基本はPukiWikiの整形ルールとなっています。
• Ver2.0から入力支援機能として、書き始めに記入用のフォームが利用できます。

  #table_edit2

  上記の記入方法で利用できます。また、このオプションフォーム機能を有効にする前に:config/plugin/table_edit2/settingのような設定をしておくとさらに便利に使えます。
  　差分で記入内容をコピーできますので、設置サイトの:config/にこのページを作ってください。
  （設定書式の仕様についてはこちらを参考にして下さい。）

define設定

• table_edit2.inc.php内部の編集です。通常は変更せずそのままお使いください。（あるていど知識が無いと変更した事でトラブルが発生するかもしれません。）

  define	説明	備考
  define('PLUGIN_TABLE_EDIT_TEXT_SIZE', 68);	編集時の文字記入欄、横サイズを指定します	Ver0.2以降
  define('PLUGIN_TABLE_EDIT_TEXTAREA_ROWS_LINE', 4);	textareaモードの文字記入欄、縦サイズを指定します	Ver1.3以降
  define('PLUGIN_TABLE_EDIT2_TEXTAREA_COLS_SIZE', 40);	textareaの入力領域幅を指定 （以前のバージョンではtextのサイズ指定を利用していましたが不便なので分離）	Ver1.8以降
  define('PLUGIN_TABLE_EDIT_TEXTAREA', 'text');	初期モード変更。text,textareaを変更する事でオプション未指定時の初期編集モードを指定できます。	Ver1.3以降
  define('PLUGIN_TABLE_EDIT_TD_SHOW', TRUE);	列編集ボタンのON,OFF、を指定できます。（付けてから動作チェックは殆どしていない…）TRUE or FALSE	Ver0.9以降
  define('PLUGIN_TABLE_EDIT2_ADD_SHOW', 1);	＋マークの追加ボタンをクリックした時の処理を変更します。 0　の時はクリックと同時に行または列を追加します。 1　追加する内容を記入してから追加をするか選べます。	Ver1.8以降
  define('PLUGIN_TABLE_EDIT2_CALC', 1);	表計算機能を　1利用　0利用しないと設定せきるようにしました。	Ver1.8以降
  define('PLUGIN_TABLE_EDIT2_HTTP_REFERER', 0);	送信だけの攻撃を回避するために用意した機能ですが、ファイアウォールやブラウザの対応によって書込みが出来なくなる事もあるので、初期値は0にして外しています。	Ver2.0以降
  define('PLUGIN_TABLE_EDIT2_ANCHR_JUMP', 0);	編集完了後、編集前の場所に戻る機能ですが、Windows系サーバで不具合が確認されたため初期値は0にして外しています。	Ver2.0以降
  define('PLUGIN_TABLE_EDIT2_CSV_UNLINK', TRUE);	csvエクスポートで作られる添付ファイルの自動削除機能を利用する場合はTRUE、利用しない場合はFALSEを設定します。 csvエクスポート機能を複数人で利用する場合はFALSEにして置いてください。	Ver2.3以降

オプション

サンプル

テストはこちらで試せます。

• サンプル１

  #table_edit2(edit=on,auth_check_off){{
  -制限を解除していますので誰でも変更できます。
  |機能|説明|形状|h
  ||||
  }}

  
  • 制限を解除していますので誰でも変更できます。

    へい		c3		0	0
    		有難う御座います
    ぷき			一つ	3/5
    これきた			して
    り	追加したぜ		た。
    日付			123

• サンプル２

  #table_edit2(edit=on,table_mod=off){{
  -ページに制限が掛かっていますので認証ユーザーのみ変更できます。
  |機能|説明|形状|h
  |行編集機能|各行の右側にあるボタン（editと表示）をクリックするとその行の編集画面に切り替わります。|鉛筆マーク|
  |行追加機能|各行の右側にあるボタン（additionと表示）をクリックすると追加が行われます。|＋マーク|
  |行編集、追加ボタンの表示、非表示切替|表組の右上にるボタンをクリックする毎に切り替わります。|×と鉛筆マークの切替|
  }}

  #table_edit2(edit=on,table_mod=off){{ -ページに制限が掛かっていますので認証ユーザーのみ変更できます。 |機能|説明|形状|h |行編集機能|各行の右側にあるボタン（editと表示）をクリックするとその行の編集画面に切り替わります。|鉛筆マーク| |行追加機能|各行の右側にあるボタン（additionと表示）をクリックすると追加が行われます。|＋マーク| |行編集、追加ボタンの表示、非表示切替|表組の右上にるボタンをクリックする毎に切り替わります。|×と鉛筆マークの切替| }}
  • ページに制限が掛かっていますので認証ユーザーのみ変更できます。

    機能	説明	形状
    行編集機能	各行の右側にあるボタン（editと表示）をクリックするとその行の編集画面に切り替わります。	鉛筆マーク
    行追加機能	各行の右側にあるボタン（additionと表示）をクリックすると追加が行われます。	＋マーク
    行編集、追加ボタンの表示、非表示切替	表組の右上にるボタンをクリックする毎に切り替わります。	×と鉛筆マークの切替

Ver1.3より title textarea form のオプションが新たに増えました。

• サンプル３

  #table_edit2(td_edit=off,title_c=2,form=text|select=_20液晶_DVD_HDD_メモリ|radio=_無_有|textarea,edit=on,auth_check_off){{

  #table_edit2(td_edit=off,title_c=2,form=text|select=_20液晶_DVD_HDD_メモリ|radio=_無_有|textarea,edit=on,auth_check_off){{
  • 制限を解除していますので誰でも変更できます。
    

    番号	オプション	選択	メモ
    1	DVD
    10	20液晶		22
    ？	DVD	有	test テスト
    t001	メモリ	有	テストです てすとです２
    １	HDD		テスト テスト テスト
    e002	DVD	有	3層式が欲しい…
    e003	HDD	無	余ってる…！！
    マシン名	メモリ	有	俺様が使うぜよ

表計算機能

• オプション
  

  calc=1	表組のセルで計算を行う
  comma	数字に３桁単位で(,)カンマを付ける
  dot=1	小数第1位まで表示（数値を増やすことで変更できる。0で無し）
  format_c	小数点やカンマの書式を指定列に限定する。指定列は,format_c=2|4,のように複数指定する事も可能 （Ver2.1より追加）

関数 セル内で使用

• 関数名の後ろに_rまたは_cがつく場合

  関数名_r	横左側の指定範囲	(開始列番号,終了列番号)
  関数名_c	縦上側の指定範囲	(開始行番号,終了行番号)

  • xを行数、yを列数とすると

    合計	@sum_r(y,y) 行	@sum_c(x,x) 列
    平均	@avg_r(y,y) 行	@avg_c(x,x) 列
    数値のセルを数える	@count_r(y,y) 行	@count_c(x,x) 列
    最大値	@max_r(y,y) 行	@max_c(x,x) 列
    最小値	@min_r(y,y) 行	@min_c(x,x) 列
    指定位置のセル値を複写する	@cell(x,y)　絶対アドレス	@cell_ra(x,y)　相対アドレス

• Ver2.0以降より新しい関数を用意しました。

  機能	関数書式	列	行
  合計	@sum(オプション)	c	r
  数値のカウント	@count(オプション)
  番号（列や行の番号を取得して表示）	@number(オプション)

• サンプル４

  #table_edit2(edit=on,auth_check_off,calc=1){{
  |||
  }}

  

  100	ABC工業	100	30	8	2	100-ABC工業	ｄさだｓｓ	0	200	200	3
  ｆｄｓ	12,345	11,111,111,111	ｓ			ｓ		0		2
  	○○太郎	y						2,016
  100+ABC工業			100+@cell_ra(3,0.1)
  								@cell_ra(0,5)=
  			テスト			8
  2				29.9999				avg2			55
  888			5	7	893		20
  31				17		16		31
  5				13		4	16	18
  7				9		8		8
  sum202				avg8		count1		@cell(4,6)=
  1		3	6	9	10	11	12				23
  (*´艸｀*)		(｀･ω･´)ゞ
  30											0

CSV機能

CSV形式ファイルのインポート、エクスポート

• この機能で使われるCSV形式ファイルとは、PukiWikiの表組み整形ルールで使われるカンマから始まるCSV形式とは違います。表計算やデーターベース等のアプリケーションから出力する時に使われるCSV形式です。
• この機能を使ってCSVファイルをPukiWikiに取り込むとデータは , (カンマ)区切りから | (パイプ)区切りに置き換えらtable_edit2プラグイン記述の複数行オプションとして保存されます（データ置換え時には行頭・行末に | を置く作業も行われます。）。
  　逆のCSVファイルを出力する時は、table_edit2プラグイン記述内に入れた表組みデータから | を , に置き換えてくれます。

import

ボタンをクリックするとファイル添付用のフォームに切り替わります。添付するファイルの文字コードを選択してから「import」ボタンをクリックしてください。
　※表は追加モード固定です。

export

ボタンをクリックするとファイルダウンロード用のフォームに切り替わります。出力用の文字コードと改行コードを選択してから「export」をクリックしてください。ダウンロードの画面に変わります。
　ダウンロード後は、「戻る」ボタンで作業ページに戻ると同時にダウンロードに使った一時添付ファイルを削除します。
（「戻る」を使わない場合、ファイルはそのまま残りますが、wiki形式で作っているので作業ページ上から削除機能で削除できます。一時添付ファイルは上書きモード固定です。）

• Excelの出力するCSVファイルは、改行コードがLF（UNIX系）です。Excelに利用する時はSJIS、UNIX(LF)を選択してください。

ダウンロード

table_edit2.inc.phpはextend/pluginへ
table_edit2.mo*1はextend/locale/ja_JP/LC_MESSAGESに置いてください。

※extend/plugin,extend/locale/ja_JP/LC_MESSAGESはplus-i18n版で追加されたディレクトリです。

表組編集支援+表計算機能バージョン

表組支援機能のみバージョン

• Ver1.8以降よりdefine('PLUGIN_TABLE_EDIT2_CALC', 0);にて計算機能を処理しない設定が可能になったため、上の表計算機能付きバージョンのみに集中して、開発を進めています。

  ファイル	Ver	日付	コメント
  table_edit2.inc.php.1.4.zip	1.4	'06/11/15	①入力アシスタントを利用できるようにしました。 ②数値文字参照が変換状態で表示される状態を修正しました。 （こちらのバージョンではtext編集時の問題はありません。たぶん…） ③キャンセルを押した時にページ先頭ではなくテーブルアンカーを目標に飛ぶよう変更しました。
  table_edit2.inc.php.1.3.zip	1.3	'06/11/14	オプションを追加しました。 title_c=1　列編集時、1列目を編集セルの項目名とします。 textarea　 この指定でtextarea編集が可能（form指定がある場合そちらを優先する） form　　　　各列に対しフォームタイプを利用可能とする。
  table_edit2.inc.php.1.2+.zip	1.2+	'06/10/28 '06/11/14	試験的にgettextに対応してみました。table_edit2.inc.phpはextend/pluginへ、table_edit2.moはextend/locale/ja_JP/LC_MESSAGESへ入れてください。 このバージョンに限りcancel処理が実行されずに削除となる状態である事が判明しましたので急遽差し替えています。
  table_edit2.inc.php.1.1	1.1	06/09/22	列追加、編集機能を追加するときに「行頭にhがあるときは項目名にする」のデーター引渡しを忘れていました。また消そうと思っていた処理や問題点も修正しました。
  table_edit2.inc.php.1.0	1.0	06/09/21	列追加、編集機能を追加しました。簡易表計算付のバージョンに合わせて1.0としました。 ※注意：　こちらのプラグインには演算機能・関数機能を付けていません。
  table_edit2.inc.php.0.7.haeder	0.7	06/09/12	確かヘッダ（h）が無いと項目にしないように0.7をちょっと変更バージョンです。直っていない場合はプログラム内の先頭でdefine('PLUGIN_TABLE_EDIT_TABLE_HEADER', 'h');にして下さい。
  table_edit2.inc.php.0.7	0.7	06/09/11	upkさんに指摘頂いたhttpsの対応方法を$_SERVER['HTTP_REFERER']の記述部に適用しました。
  table_edit2.inc.tgz	0.6	06/09/11	編集時にタイムスタンプを付けない事ができる様にチェックボタンを追加 行追加、編集モード表示・非表示切替の時は強制でタイムスタンプを解除します。
  table_edit2.inc.php.0.5	0.5	06/09/10	先頭の切り替えボタンで行編集アイコンを表示、非表示に切り替える
  table_edit2.inc.php.0.4	0.4	06/09/10	アイコンリンクボタンを付ける為のinline pluginを コード内に追加しました。
  table_edit2.inc.php.0.3	0.3	06/09/10	行編集画面に「cancel」、「delete」を追加しました。 インラインのコードを追加する前のバックアップでup
  table_edit2.inc.php.0.2	0.2	06/09/10	テキストエリアのサイズをdefineで設定可能 行追加機能追加
  table_edit2.inc.php.0.1	0.1	06/09/09	とりあえず編集が可能 制限ページの挙動確認済み

ちなみに

• PukiWiki1.4.6で試してみたところ認証チェックでエラーでまくりでした。table_edit2.inc.php Ver 0.3の24,46-48,84をコメントアウトするか変更すれば動くかもです。
  • Ver1.8以降から本家PukiWiki1.4.7で利用できない関数参照をチェックしエラーを回避するようにしました。この効果でplus-euc版も利用可能と思います。(本家とplus-euc版ではメッセージが日本語で表示されません。)
• このページの表は全部table_edit2プラグインを利用しているのですが、予想外に便利ですね。最大の理由がこのページで使われている表の場合、似通った文字が何度も使われるからです。つまり先頭文字で過去同じ文字を使った入力内容の候補が出てくるのです。（オートコンプリート機能だったかな？）
• 現在の仕様（0.7）だと h（ヘッダ指定）が置かれている行で追加を行うとその内容をコピーしてしまいます。次のバージョンで修正しないとなぁ…。

  0 1 2 3 4 5 6 7 8 9 10

  if($vars['edit_mod'] == 'tr'){ //tr $notimestamp = TRUE; $source_s .= $args_line; $match_t = explode("|", $match_line[1]); $source_s .= '|'; foreach ($match_t as $cell){ $source_s .= '|'; } - $source_s .= $match_line[2] . ' + $source_s .= ' '; }

  #code(diff){{ if($vars['edit_mod'] == 'tr'){ //tr $notimestamp = TRUE; $source_s .= $args_line; $match_t = explode("|", $match_line[1]); $source_s .= '|'; foreach ($match_t as $cell){ $source_s .= '|'; } - $source_s .= $match_line[2] . ' + $source_s .= ' '; } }}
  • $match_line[2]が蛇足でした。
• 行・列追加用の＋マーク（）mini_add.pngは06.09.10以降のPlus!-i18n SVNに含まれています。それ以前のバージョンを使っている場合は画像を右クリックして「名前を付けて画像の保存」を選んでください。

コメント