出納係2.0変更マニュアル
この度は紅月堂本舗リリースの出納係をDLしていただきありがとうございました。
当スクリプトはソードワールドTRPG2.0(以下SW2.0)をオンラインでより楽しむために開発されたスクリプトです。

ここでは出納係2.0の変更方法をご説明いたします。
このファイルを見てもよくわからない、動作がおかしい等ありましたら紅月堂FAQを参照いただくか、こちらまでお問い合わせください。
なお、同梱したREADMEは必ずお読みいただくようお願いいたします。

[ver0.6以前のバージョンからバージョンアップする場合の注意]
[ver0.9以前のバージョンからバージョンアップする場合の注意]
[従来のファイルをUTF-8形式ファイルに変換する方法]


CGI設置:設置例[ ] 内はパーミッション

public_html / index.html (ホームページ)
   |
+-- chara [777] / chara.cgi[755]
characfg.cgi[644]
cedit.cgi[755]
charaf.cgi[644]
charadef.cgi[644]
main.cgi[644]
mail.cgi[644]
wepon.cgi[644]
dcnt.dat[644]
fc.cgi[644]ver0.5追加
listdat.cgi[644]ver0.6追加
umare.dat[644]ver1.0追加
skill.dat[644]ver1.0追加
script.js[644]ver0.6追加
Jcode.pm[644]ver0.9追加
jcode.pl[644]ver0.9削除
cgi-lib.pl[644]ver0.7追加
style.css[644]
lstyle.css[644]
faq.txt[644]ver0.7追加 ver1.0削除
faq.dat[644]ver1.0追加
(script_old.js)[644]ver0.9追加
chara2.0chg.cgi[755]ver0.7追加
chara2.0chg2.cgi[755]ver0.9追加
生まれ.xls転送不要ver1.0追加

CGI設置:characfg.cgi
3〜7行目 ヘッダ情報
紅月堂本舗のアドレス変わりましたので従来のファイルに反映させる際はご注意下さい

11〜14行目 require
jcode.plおよびサブルーチンの場所を指定しています。
基本的に変更の必要はありません。
※ver0.9にてJcode.pmを導入しました。

16行目 $pass
管理用パスワードです。必ず変えてください。

17行目 $add_usr
ユーザーによる新規登録 0:許可しない 1:許可する 2:共通パス($spass)を知るユーザーのみ許可する。

19行目 $script
スクリプトの名前を指定します。

20行目 $cedit
データ書込用CGIの名前を指定します。

21行目 $cfile
データを保存するファイルの名前と場所を指定します。こちらにはキャラクター情報が保存されます。

22行目 $mfile
データを保存するファイルの名前と場所を指定します。こちらにはメールアドレスが保存されます。

23行目 $wfile
データを保存するファイルの名前と場所を指定します。こちらには武器情報が保存されます。

24行目 $dfile
データを保存するファイルの名前と場所を指定します。こちらには欠番IDが保存されます。

25行目 $ffile
データを保存するファイルの名前と場所を指定します。こちらにはフリーコメントが保存されます。

26行目 $lfile
データを保存するファイルの名前と場所を指定します。こちらにはリスト表示項目が保存されます。

27行目 $sfile
データを保存するファイルの名前と場所を指定します。こちらには技能情報が保存されます。
変更方法は「生まれ.xls」を参照してください。

28行目 $ufile
データを保存するファイルの名前と場所を指定します。こちらには生まれ情報が保存されます。
変更方法は「生まれ.xls」を参照してください。

29行目 $home
HPのアドレスを指定します。

30行目 $max
最大保持件数です。多過ぎると重くなります。これを超えたデータは自動的に消去されます。
0を指定すると上限チェックをおこないません。

31行目 $p_max
1ページの最大表示件数です。多すぎると(以下略)

32行目 $slock
検索時にデータロックを適用するか否か

41行目 $title
出納係タイトル

42行目 $ftitle
出納係管理画面タイトル

43行目 $lstyle
リスト表示時に使用するスタイルシート
※指定の際はフルパスを指定してください

44行目 $flg_rid
欠番IDに新規データを追加する際 0:自動採番する。 1:IDを指定して採番号する。

48行目 $ad1
変更時の新規武器入力欄数

49行目 $ad2
新規登録時の武器欄数

51行目 $cck
Charactor Name欄および生年月日欄を表示するかどうか。

53行目 $bc
生年月日の前に表示する暦名 ※$cck=1の時のみ表示されます。

55行目 $uchg
ユーザー変更にて能力値とダイス値の編集を許可するかどうか。

57行目 $flg_sosk
装飾品欄を表示する。 0:表示しない 1:表示する。

59行目 $spass
初回登録時に発行する共通パス 
※空欄の場合、個別にパスワードを入力する必要があります。

60行目 $sstyle
シート表示時に使用するスタイルシート
※指定の際はフルパスを指定してください

63行目 $mailto
あなたのmailアドレス

64行目 $sendmail
SendMailのパス

65行目 $lib
html出力フォルダ名

66行目 $dmmy
名前(横文字)が入力されていない場合のhtmlファイル名

67行目 $imglib
画像出力フォルダ名
※最後の「/」まで入力してください

70行目 $path
CGIが設置されているパス(最後の/まで)

73行目 $inform
プレイヤーにHTMLのアドレスを通知 0:通知しない 1:通知する(新規作成) 2:通知する(更新毎)

76行目 $send
管理人へ確認メール 0:送信しない 1:送信する(ユーザ更新のみ)2:送信する(すべての登録/更新)

80−84行目 $head
HTMLヘッダー内容
メタタグを追加する場合ここに記入してください。

87行目 $flg_fc
#フリーコメント欄を 0:使用しない 1:使用する

88行目 $max_fc
#フリーコメントの文字数制限 
使用しない場合:0
使用する場合:制限となる文字数(byte単位:全角文字に換算する場合は制限したい文字数を二倍にした値)
※改行はカウントに入りません。

89行目 $flg_new
次バージョンの更新が合った場合 通知しない:0 通知する:1

90行目 $flg_igt
画像データの取得方法 0:URL入力のみ 1:画像アップロードのみ 2:両方を許可する

91行目 $img_maxsize
画像データの最大サイズ(単位:KB)

95行目 $pmsg
ユーザー登録を共通パスワードを知る人に限定する($add_usr=2)の場合、パスワード入力欄に表示するテキスト

表示に関わる変数
101行目 @sx
性別(シート表示時)

102目 @sxl
性別(リスト表示時)

105目 @sta
状態(シート表示時)

106行目 @stad
状態(リスト表示時)


characfg.cgi 変更点
※バージョンを上げる際に手持ちのcharacfg.cgiに追加する変数です。

追加・変更された変数名変更があったバージョン
$flg_rid(0.1→0.3)
$flg_sosk(0.1→0.3)
$add_usr(0.3→0.4)
$ffile(0.4→0.5)
$flg_fc(0.4→0.5)
$max_fc(0.4→0.5)
$lfile(0.5→0.6)
$flg_new(0.5→0.6)
$pmsg(0.5→0.6)
require "./cgi-lib.pl";(0.6→0.7)
$imglib(0.6→0.7)
$flg_igt(0.6→0.7)
$img_maxsize(0.6→0.7)
(Jcode.pm)(0.8→0.9)
$URL(0.8→0.9)
$sfile(0.9→1.0)
$ufile(0.9→1.0



自動送信メール:cedit.cgi

1542〜1544行目 
ユーザーへの自動送信メールの内容。
1552〜1554行目 
管理人への自動通知メールの内容。
改変なさる場合はPGMの部分を消さないようにお願いします。
共通パスを設定していない場合、個別にパスワードの通知メールを送っていただくようお願いいたします。
[用語解説]
$date:日付
$c_name:キャラクターネーム
$spass:初回登録時に発行する共通パス
$mailtitle:なにがなされたのかが書き込まれます。例)新規作成・変更
$fullpath:キャラクターシートがおかれているパス
$host:最終変更時のホストを表示


キャラクターシート表示:charaf.cgi

基本的に変更は推奨していません。
このデータを元にHTMLも出力しています。

ver0.5更新時に追加がされています。
変更を行なわれている方は「##ver0.5 update」〜「##ver0.5 update END」の行をコピーし、編集済みのcharaf.cgiに追記してください。

ver0.5、ver0.6、ver0.7にて大幅に編集がされています。
一旦差し替えの上再編集をおこなう方が安全と思われますのでご注意下さい。


生まれセット:script_old.js

通常は利用しないのでアップロードする必要はありません。
生まれ選択画面にて自動選択リストを使用したくない場合、従来の「script.js」を削除し、「script_old.js」を「script.js」にリネームしてアップロードしてください


使用上の注意

1.登録は管理者以外できません。バージョン0.4よりユーザーによる登録機能を搭載しました。
ただし、初期設定ではユーザーによる登録を許可していません。
これは登録だけをするのを防ぐ、荒らし目的の投稿を防ぐためです。
お手数ですが、必要があれば設定を変更して機能を有効にしてください。

ユーザーによる登録機能について
 新規登録について、とくに制限を設けない場合は$add_usrを「1」と設定してください。この場合、どのような情報でも入力されてしまうため、いたずらや広告のような内容であっても入力に制限はありません。
 新規登録を可能とするユーザーをある程度囲い込んでおきたい場合は、$add_usrを「2」と設定してください。その上で、共通パス($spass)の値を仲間内で共有いただくことで、この共通パスを知らない人間からの登録を規制することが可能となります。
 なお、ユーザーによる登録機能を利用する際は無条件でユーザー変更にて能力値とダイス値の編集を許可するように設定されています。

2.管理画面から新規作成の場合はチェックボックスやラジオボタンを使用せずに実行してください。
新規作成画面が表示されます。
欠番使用時は、実行ボタンの横のセレクトボックスから欠番IDを選択して実行してください。
同様に、変更の場合は変更したいシートのラジオボタンにチェックを入れて実行、削除の場合は削除したいシートのチェックボックスにチェックをいれて実行してください。

3.ユーザがパスワード変更した後に管理人がキャラクターシートを修正する場合パスワード欄が空白で表示されますが、パスワード欄にはなにも入力しないでください
ブランクのまま送信するとパスワードはもとのまま保存されますが、何か入力するとパスワードを変更してしまいます。
逆に、パスワードを忘れた人には変更画面で管理人がパスワードを入力すれば新しいパスワードに変更できますので、それをユーザに通知して変更しなおしてもらってください。
(ユーザ画面では画面にパスワードが表示されるので特に注意することはないです)

4.キャラクターシートのファイル名は「キャラクター名(英数).html」となります。
キャラクター名(英数)が入力されていない場合は「$dmmy$id.html(例:dmmy1.html )」となります。
dmmyから英数に変わった際は変わる前のシートを自動削除しますが、英字から英字の場合はファイルがのこってしまうのでHPの容量等気をつけてください。

5.htmlへの出力
画面右端のチェックボックスにチェックをいれて実行するとhtmlの出力を行います。

6.cgi-lib.plについて 20090109追記
画像の最大サイズを変数に持たせるため、出納帳同梱のファイルには一部編集を行っています。
cgi-lib.plサイトからダウンロードしたものを利用される場合は、cgi-lib.pl本体で画像の最大サイズを編集してください。


ver0.6以前のバージョンからバージョンアップする場合の注意

ver0.6以前のデータから移行を行う際には、chara2.0chg.cgiを他のスクリプトと同じフォルダに転送、パーミッションを755に変更して実行してください。
データファイルのソート順番を整理し、ファイルを更新します。
[注意] 元のデータファイルは必ずバックアップを行ってください。破損したとしても責任は負えません
作業終了後はchara2.0chg.cgiを削除してください。
なお、こちらの作業は必ずバージョンをあげる前に行ってください。
このスクリプトはver0.9環境では動作できません。


ver0.9以前のバージョンからバージョンアップする場合の注意

※注意※ver0.6以前のデータから移行を行う際には、あらかじめ「ver0.6以前のバージョンからバージョンアップする場合の注意」の手順をすませてください。

従来から利用している以下のファイルについて、置き換えやデータの変換を行う必要があります。
ファイル名必要な操作ファイル名必要な操作
chara.cgi置き換え必須characfg.cgi置き換え必須
cedit.cgi置き換え推奨charaf.cgi置き換え推奨
charadef.cgi置き換え必須main.cgiデータ変換必須
wepon.cgiデータ変換必須fc.cgiデータ変換必須
listdat.cgi置き換え推奨script.js置き換え必須
faq.txt置き換え必須

置き換え必須:新しいバージョンのファイルを利用してください。該当ファイルを編集している場合は、新しいバージョンのファイルを再度編集して利用ください。
置き換え推奨:新しいバージョンのファイルを利用する、もしくは[
従来のファイルをUTF-8形式ファイルに変換する方法]にて従来のファイルを置き換えてください。
データ変換必須:chara2.0chg2.cgiを利用してデータを変換してください。

※注意※[従来のファイルをUTF-8形式ファイルに変換する方法]でデータファイル(main.cgi,wepon.cgi,fc.cgi)を変換した場合は以下の操作を行わないでください。

ver0.9以前のデータから移行を行う際には、chara2.0chg2.cgiを他のスクリプトと同じフォルダに転送、パーミッションを755に変更して実行してください。
データファイルのソート順番を整理し、ファイルを更新します。
[注意] 元のデータファイルは必ずバックアップを行ってください。破損したとしても責任は負えません
作業終了後はchara2.0chg.cgi2およびconvtmp.txtを削除してください。
※convtmp.txt=二重操作防止用ロックファイル