SUNVML BOARD

• 特徴
• お絵描き機能の使い方 v1.2〜
• サンプル
• CGIスクリプト利用規定
• ダウンロード
• 設定(初期導入手順)
• バージョンアップ手順・解説
• オリジナル版からの移行について
• お絵かきエディタ設定解説(各ソフト共通) v1.2〜
• 変更履歴

特徴

• 'SUNVML BOARD' はKentWebさんのポピュラーな掲示板のひとつ'SUN BOARD v3.8'(HTMLボード) (以後"オリジナル(版)"と表記) に
  VMLによるお絵描き・その他の機能を付加したものです。
  
  
• 掲示板の基本機能(オリジナルの機能)
  
  ※掲示板の基本機能はオリジナルのままです。
  • 表示部がＨＴＭＬ形式なので、表示が軽くサーバに負担をかけません。
  • 「設定」で書込みを管理者限定にすることもできます。これにより、新着情報のページや日記のページ等にも応用が可能です。
  • 各記事に対して返信レスを付けることができます。
  • 管理者による記事削除はもちろん、編集処理も可能です。
  • キーワードから過去の投稿記事の簡易的な検索をすることができます。
  • 投稿記事の内容を管理者あてに自動メールが可能。（sendmailの使えるプロバイダのみ）
  
  
• 追加機能  
  
  
  • WEBブラウザによる環境設定機能。(ほとんどの設定を行うことが出来ます。)
  • お絵描き機能
    • 作画機能(VMLお絵かきエディタ)
      • 図形種類:フリーハンド、直線、折れ線、四角形、角丸四角形、楕円、円弧、カーブ
      • 線の色、太さ、透明度を指定できます。
      • 塗潰しの色、透明度を指定できます。
      • 各図形に文字列を出力できます。
      • アンドゥ、リドゥ、削除機能。
    • VMLお絵かきエディタ
      
      • 投稿部から別ウィンドウで開かれます。
        基本スタイルを変更することができます。
        タグ広告・独自のメッセージなどを画面の予備領域(上下左右)に配置させることができます。
        何れもブラウザによる環境設定で手軽に編集することができます。
      • お絵かきエディタはv1.2で３タイプ添付しています。
        将来デザインや機能を増やしたエディタを提供することも考えています。
        そのような時にファイルの追加をしやすくなっています。
    
    
  • スパム書き込みへの対策。(ちょっとした対策ですが効果は確認済みです。)(*1)
  • タグ広告を設定しやすくしました。(こちらもブラウザによる環境設定対応です)
  
  *1 : 全てのスパムを防ぐことを保証するものではありません。
  
  
• 動作条件
  
  
  • Perlが動くサーバーであれば設置できます。(*2)
    ※GDモジュールなどは不要です。
  • お絵描きする時はJavascriptをオンにしてお使い下さい
  • お絵かき閲覧・作画にはInternetExplorerまたはIE互換ブラウザが必要です。
    文字のコミュニケーションではこの限りではありません。
    
  
  *2 : 全てのサーバで正常に動作する事を保証するものではありません。
  

サンプル

• SUNVML BOARD v1.3     テスト書込み可能です。
  ※ご質問・リクエストなどは サポート掲示板 にお願いします。
  
  
• 管理画面サンプル(設定)    　変更はできません。
  
  
• 管理画面サンプル(お絵かきエディタ設定)    　変更はできません。
  

CGIスクリプト利用規定

• CGIスクリプト利用規定(Kent-web)
  
  
• このスクリプトはフリーソフトです。このスクリプトを使用したいかなる損害に対しても作者は一切の責任を負いません。
  
  
• 使用者はスクリプトの著作権表示を削除することはできません。
  

ダウンロード

• ダウンロードされた時点で上のCGIスクリプト利用規定に同意したものとみなします。
  
  
• sunvmlbbs.lzh   v1.3
  sunvmlbbs.zip   v1.3
  
  
• sunvmlup.lzh   v1.3 (アップデート用)
  sunvmlup.zip   v1.3 (アップデート用)
  　実行に必要なファイル全てとアップデート作業用スクリプト類を含みます。
  
  
• 説明文は添付していません。
  
  • サーバーへの設置と設定
  • バージョンアップ手順・解説
  • お絵かきエディタ設定
  
  
• 画像ファイルはお絵かきエディタメニューボタン用(私の自作品)のもの以外は添付しておりません。
  
  
• ダウンロードされた方は(強制ではありませんが) 掲示板 に報告お願いします。
  設置に関する疑問・質問などもこちらにお寄せください。
  

設定

1. public_html (ホームディレクトリ) の下に、「bbsディレクトリ」(例)を作成し、さらにその下に以下のディレクトリを作成します。
   
   
   • 「lockディレクトリ」[707] (ロックファイル用)
   • 「pastディレクトリ」[707] (過去ログ用)
   • 「imgディレクトリ」[604] (gifファイル用)
   • 「vmlディレクトリ」[707] (お絵かきデータ保存用)
   
   
   

   【ファイル構成例】 public_html / index.html (トップページ) | +-- bbs / sunvmlbbs.cgi [705] | sunvml_conf.cgi [606] | sunbbslog.cgi [606] | index.html [606] | index2.html [606] | jcode.pl [604] | pastno.dat [606] ...(過去ログ用) | vmlno.cgi [606] | vml0.js [604] | vml.js [604] | vmledit1.html [606] ... 〜3.html | +-- past [707] / 0001.dat [606] ...(過去ログ用) | +-- lock [707] / | +-- img [604] / *.gif [604] | +-- vml [707] / 1.cgi , 2.cgi ... [606] お絵かきデータ

2. sunvmlbbs.cgi を エディタ で開いて以下の箇所を修正します。

   　#!/usr/local/bin/perl

   　（プロバイダで定められたPerlへのパスを指定します）
   
   

   
   
   

3. 修正が完了したら上記ファイルをFTP転送し、以下のとおり パーミッション を設定します。

   ファイル名	パーミッション		転送モード
   	一般サーバ	suEXECサーバ CGIWrapサーバ
   sunvmlbbs.cgi	755 or 705	701 or 700	アスキー
   sunvml_conf.cgi	666 or 606	600	アスキー
   sunbbslog.cgi	666 or 606	600	アスキー
   index.html	666 or 606	600	アスキー
   index2.html	666 or 606	600	アスキー
   pastno.dat	666 or 606	600	アスキー
   jcode.pl	644 or 604	600	アスキー
   vmlno.cgi	666 or 606	600	アスキー
   vml0.js	644 or 604	600	アスキー
   vml.js	644 or 604	600	アスキー
   vmledit1.html 〜3.html	666 or 606	600	アスキー
   lockディレクトリ	777 or 707	701 or 700	-
   pastディレクトリ	777 or 707	701 or 700	-
   past/0001.dat	666 or 606	600	アスキー
   imgディレクトリ	644 or 604	600	-
   img/*.gif	644 or 604	600	バイナリ
   vmlディレクトリ	777 or 707	701 or 700	-
   vml/1.cgi ...	666 or 606	600	アスキー

   
   
   

4. http://〜〜/bbs/sunvmlbbs.cgi?mode=admin にアクセスして次の手順で環境設定を行います
   注意: sunvmlbbs.cgi の末尾に「?mode=admin」を付けて呼び出す
   
   
   1. ログイン画面で、[設定]を選択しパスワード(初期値)"0123"でログインする
      
      
   2. 設定画面で任意の項目を変更する
      (主要な項目には解説がありますので参考にして下さい)
      ***パスワードは初期値のままにせず必ず変更して下さい***
      (ローカルサーバでテストする時にも変更して下さい)
      
      
   3. 設定を保存する
      (保存の時点で表示ファイル 〜/bbs/index.html の内容が書き換わります)
      
   
   ※環境設定について以上の説明では不足という方は現在工事中ですが設定の補足を見て下さい。
   
   
   
5. 最後に、HTMLから index.html にリンクしてください。
   
   

   【記述例】

   <a href="http://〜〜/bbs/index.html">掲示板</a>

バージョンアップ手順・解説

アップデート作業の概要

1. 旧バージョンのディレクトリ以下のファイルをバックアップする。
   
2. 新しいディレクトリ「newdir」を作成し、新バージョンのファイルを転送する。
   
3. 「newdir」でupdate.cgiを実行する。
4. 「olddir」ディレクトリを適当な名前「例:oldbak」にリネーム、
   「newdir」ディレクトリを「olddir」にリネームする。
   「olddir」でsunvmlbbs.cgiを実行し最終的な環境設定とテストを行う。

アップデート作業

1. ダウンロード で (アップデート用) のファイルを入手して下さい。
   
   
   
2. 現在お使いの "SunVML BOARD" のバージョン確認。
   sunvmlbbs.cgiをエディタで開いて、上部著作権表示内の 〜 vX.X 〜 を確認しておいて下さい。 (例: v1.0 , v1.2 など)
   
   
   
3. バックアップ
   以降の作業に入る前に必ずバックアップを行って下さい。
   (旧バージョンのディレクトリ「olddir」以下のディレクトリとファイル)
   
   
   
4. sunvmlbbs.cgi (v1.3) を エディタ で開いて以下の箇所を修正します。
   
   
   • #!/usr/local/bin/perl
     　（プロバイダで定められたPerlへのパスを指定します）
   
   
   
5. update.cgi を エディタ で開いて以下の箇所を修正します。(重要項目のみ)
   
   
   1. #!/usr/local/bin/perl
      （プロバイダで定められたPerlへのパスを指定します）
      
      
   2. # ■ パスワード
      # 　　このパスワードはアップデート作業に限り使用されるもので、sunvmlbbs.cgi本体のそれとは異なります。
      $pass = '0123';
      
      
   3. # ■ ロックファイル
      #　 0 : 行なわない
      #　 1 : 行なう（symlink関数式）
      #　 2 : 行なう（mkdir関数式）
      $lockkey = 0;
      
      
   4. # ■ 旧設定ファイル
      #　 旧バージョンが v1.2 の場合は旧設定ファイル( sunvml_conf.cgi ) のパスを正しく指定して下さい。
      #　 旧バージョンが v1.0〜v1.1a の場合は設定ファイルがありませんので、$setfile_v1_3 と同じ './conf_1_3.cgi' を指定します。
      #$setfile_old = './conf_1_3.cgi'; #v1.0〜v1.1a の例
      $setfile_old = '../olddir/sunvml_conf.cgi'; #v1.2 の例
      
      
   5. # ■ 旧ログファイル
      # 旧バージョンのログファイルパスを正しく指定して下さい
      $logfile_old = '../olddir/sunbbslog.cgi';
      
      
   6. # ■ 新ログファイル(v1.3)
      # 旧バージョンでログファイルの名前を標準と異なるものに設定していた場合はその名前を指定して下さい。
      # その他の場合は特に変更の必要はありません。
      # 注意1 : ディレクトリは newdir を指定します。
      # 注意2 : $logfile_old と同じディレクトリ・ファイルを指定しないで下さい。
      $logfile_new = './sunbbslog.cgi';
      
      
   7. # ■ 過去ログ機能 (0=no 1=yes)
      $pastkey = 1;
      
      
   8. # 過去ログのディレクトリ (旧バージョン) (最後は / で閉じる)
      $pastdir_old = '../olddir/past/';
      
      
   9. # 過去ログのディレクトリ (新バージョン) (最後は / で閉じる)
      $pastdir_new = './past/';
      
      
   10. # 過去ログカウントファイル (旧バージョン)
       $pastno_old = '../olddir/pastno.dat';
       
       
   11. # 過去ログカウントファイル (新バージョン)
       $pastno_new = './pastno.dat';
       
       
   
   ※$logfile_old , $setfile_old 共 ’．．／ｏｌｄｄｉｒ／〜’ の「olddir」部分は旧バージョンの実際のディレクトリ名を指定して下さい。
   
   ※8. 〜 11. の項目は 7. 過去ログ機能が1の時に設定します。
   
   これらの設定に間違いがあると後の作業が正しく行えなくなりますので慎重に設定して下さい。
   
   
   
   
6. 新しいディレクトリ「newdir」を「olddir」ディレクトリと同じ階層に作成します。
   例:
   http://xxx.xxx/cgi-bin/olddir が旧ディレクトリであったら
   http://xxx.xxx/cgi-bin/newdir というディレクトリを作成します。
   http://xxx.xxx/cgi-bin/xxx/newdir ← このような異なる階層は ×
   
   
   
   
7. 「newdir」の下に次のディレクトリを作成して下さい。([xxx]はパーミッション例)
   
   
   • 「lockディレクトリ」[707] (ロックファイル用)
   • 「pastディレクトリ」[707] (過去ログ用)
   • 「imgディレクトリ」[604] (gifファイル用)
   • 「vmlディレクトリ」[707] (お絵かきデータ保存用)
   
   
   
8. 「newdir」以下のディレクトリ構成とファイル位置は以下のとおりです。（かっこ内はパーミッションの設定値）
   
   

   【ディレクトリ構成例】 public_html / index.html (トップページ) | +-- <olddir> / 〜 略 〜 | | +-- <newdir> / | sunvmlbbs.cgi [705] | sunbbslog.cgi [606] (*1) | sunvml_conf.cgi [606] (*1) | index.html [606] | index2.html [606] | jcode.pl [604] | pastno.dat [606] ... 過去ログを生成する場合 | vmlno.cgi [606] | vml0.js [604] | vml.js [604] | vmledit1.html [606] ... 〜3.html | | conf_1_3.cgi [604] (*2) | update.cgi [705] (*2) | +------ <lock> [707] / | +------ <past> [707] / 0001.dat ... [606] ... 過去ログを生成する場合 | +------ <img> [604] / *.gif [604] | +------ <vml> [707] / 1.cgi , 2.cgi ... [606] お絵かきデータ (*1) *1 : update.cgi実行後生成されます *2 : アップデート作業完了後削除可

   
   
   
9. ファイルを「newdir」以下にFTP転送し、以下のとおり パーミッション を設定します。
   
   
   

   ファイル名	パーミッション		転送モード
   	一般サーバ	suEXECサーバ CGIWrapサーバ
   sunvmlbbs.cgi	755 or 705	701 or 700	アスキー
   sunvml_conf.cgi (update.cgiで自動生成)	−	−	−
   sunbbslog.cgi (update.cgiで自動生成)	−	−	−
   pastno.dat (update.cgiで自動生成)	−	−	−
   jcode.pl	644 or 604	600	アスキー
   vml0.js	644 or 604	600	アスキー
   vml.js	644 or 604	600	アスキー
   vmledit1.html 〜3.html	666 or 606	600	アスキー
   vmlno.cgi	666 or 606	600	アスキー
   update.cgi	755 or 705	701 or 700	アスキー
   conf_1_3.cgi	644 or 604	600	アスキー
   lockディレクトリ	777 or 707	701 or 700	-
   pastディレクトリ	777 or 707	701 or 700	-
   past/0001.dat ... (update.cgiで自動生成)	666 or 606	600	アスキー
   imgディレクトリ	644 or 604	600	-
   img/*.gif	644 or 604	600	バイナリ
   vmlディレクトリ	777 or 707	701 or 700	-
   vml/1.cgi ... (update.cgiで自動生成)	666 or 606	600	アスキー

   
   
   
   
10. アップデート作業中、旧バージョンのデータにアクセスされないようにする。
    
    以降の作業の前に、 http://〜/olddir 内の　主要ファイルを一時的に仮の名前に変更する。
    − 例 −
    
    • index.html → index_.html
    • index2.html → index2_.html
    • sunvmlbbs.cgi → sunvmlbbs_.cgi
    
    これは一例に過ぎません。その他適当な方法で旧バージョンファイルにアクセスされないようにして下さい。
    (尚アップデート作業では 旧バージョンの上記ファイルにアクセスすることはありません。)
    
    
    
11. http://〜/newdir/update.cgi にアクセスして次の手順で作業を行います。
    
    
    1. 設定ファイル作成
       
       v1.2 → v1.3 の場合は旧設定情報を引き継いで新しい設定ファイルが作成されます。
       v1.0〜v1.1a → v1.3 の場合は別途環境設定(最終設定の項で説明)が必要になります。
       
       [設定ファイル作成]を選択。 5-2. で設定したパスワードを入力して[実行]をクリックする。
       
       
       1. 「処理が終了しました。」となったら 例〜/newdir/sunvml_conf.cgi が生成されています。
          
          
       2. エラーが出たときは次の点を確認・修正後再実行して下さい。(注)
          
          • "Open Error: 〜"　の場合　　(関連: update.cgiの$setfile_old )
            　　ファイル又はディレクトリの指定が正しくない可能性があります。
            
          • "Write Error: 〜"　の場合　　(関連: update.cgiの$setfile_new )
            　　ディレクトリのパーミッションが正しくない可能性があります。
            
          
          
       
       
       
    2. ログ変換・更新
       
       旧ログファイル(例 : 〜/olddir/sunbbslog.cgi)をv1.3形式に変換して
       新しいファイル(例 : 〜/newdir/sunbbslog.cgi)が作成されます。
       
       [ログ更新]を選択。 5-2. で設定したパスワードを入力して[実行]をクリックする。
       
       
       1. 「正常に処理されました。」となったら以下の状態になっています。
          
          
          • newdir/sunbbslog.cgiが作成されます。
          • newdir/past/0001.dat ... が作成されます。(5-7. 過去ログ機能が1の時)
          • newdir/vmlディレクトリ の中にいくつかの 1.cgi , 2.cgi ... ができています。
            　　(お絵かき作品の数だけファイルが作られます)
            　　(ちなみにファイル名の番号は記事の番号とは無関係で又古い順という訳でもありません)
            
          
          
       2. エラーが出たときは次の点を確認・修正後再実行して下さい。(注)
          
          • "(reg_vml)Open Error: 〜"　の場合　　(関連: update.cgiの$vml_nofile )
            
          • "(reg_vml)Write Error: 〜"　の場合　　(関連: update.cgiの$vml_nofile 又は $vml_dir(規定値 ./vml) )
            　　ファイルかディレクトリが見つからない又はパーミッションが正しくない可能性があります。
            
          • "Open Error: 〜"　の場合　　(関連: update.cgiの$logfile_old )
            　　ファイル又はディレクトリの指定が正しくない可能性があります。
            
          • "Write Error: 〜"　の場合　　(関連: update.cgiの$logfile_new )
            　　ディレクトリのパーミッションが正しくない可能性があります。
            
          
          
    
    1.設定ファイル作成 、 2.ログ変換・更新 共に正常に処理できた時は、次の最終設定・動作確認の作業に移ります。
    
    
    注 : エラーその他の理由でupdate.cgiの実行をやり直すときは下記のようにして下さい。
    
    
    1. 設定ファイル作成 をやり直す時
       
       
       • newdir/sunvml_conf.cgi を削除する。(ファイルがあった場合)
       
       
       
    2. ログ変換・更新 をやり直す時
       
       
       • newdir/sunbbslog.cgi を削除する。(ファイルがあった場合)
       • newdir/past/0001.dat ... 全てを削除する。(ファイルがあった場合)
       • newdir/vmlディレクトリ内の 1.cgi , 2.cgi ... 全てを削除する。(ファイルがあった場合)
       
       
       
    
    
    
    
12. 最終設定・動作確認
    
    
    1. 「olddir」ディレクトリを適当な名前 例 :「oldbak」にリネームする
       
       
    2. 「newdir」ディレクトリを「olddir」にリネームする
       
       
    3. http://〜/olddir/sunvmlbbs.cgi?mode=adminにアクセスして以下の作業を行います。
       注意: sunvmlbbs.cgi の末尾に「?mode=admin」を付けて呼び出す
       旧バージョンv1.2でスクリプト名をsunvmlbbs.cgiと異なる名前に設定していた場合はアクセス前にファイル名自体をその名前に変更しておく必要があります。
       
       
       1. サーバエラーが出る時
          エラーが出た時は以下の点を確認・修正する
          
          1. sunvmlbbs.cgi の修正箇所 (例: #!/usr/local/bin/perl ) が正しいか
          2. sunvmlbbs.cgi のパーミッションが正しいか
          
          
          
       2. 管理画面(設定)にログイン・設定をする。
          ※ログイン画面では[設定]を選択します。
          
          
          1. v1.2 → v1.3 は以前使っていたパスワードでログインできて設定情報が引き継がれていれば問題ありません。
             もしログインできない、設定が引き継がれていない等の場合はupdate.cgiの$setfile_oldで指定したファイルが正しいか再確認、11-1.の[設定ファイル作成]を再実行して下さい
             
             
          2. v1.0〜v1.1a → v1.3 では以下のように環境設定を行って下さい。
             
             1. ログインパスワード(初期値)"0123"でログインする
                
                
             2. 設定画面で任意の項目を変更する
                (主要な項目には解説がありますので参考にして下さい)
                ***パスワードは初期値のままにせず必ず変更して下さい***
                
             
             
          3. 設定を保存する
             ※特に設定を変更しなかった場合でも初回は必ず保存して下さい。
             　これにより表示ファイル( index.html , index2.html )が生成・更新されます。
             
          
          
          
    4. http://〜/olddir/index.htmlにアクセスして以下の作業を行います。
       
       
       1. 記事・お絵かき作品が正常に表示されていることを確認する。
          
          エラーが出た時は以下の点を確認・修正する
          
          • 掲示板は表示されるが記事部分に「Open Error : 〜」などのエラー表示が出る時
            　　管理画面にログイン(後述)して以下の項目を確認修正します。
            1. [ログファイル] (例: ./sunbbslog.cgi ) が正しいか。
               ファイル名、パーミッションは正しいか。
            
            
          • 記事は表示されるが画像表示部分に「Open Error 〜」のエラー表示が出る時
            　　管理画面にログイン(後述)して以下の項目を確認修正します。
            1. [お絵かきデータ保存ディレクトリ] (例: ./vml )
               
            2. [お絵かきデータNo管理ファイル] (例: ./vmlno.cgi )
               ファイル名、パーミッションは正しいか。
          
          
       2. 「お絵かきエディタ」の環境設定をして下さい。
          
          • この設定が初めての方は解説ページの「お絵かきエディタ設定」をご覧下さい。
            
            
          • v1.2 → v1.3 の場合
            　　v1.2 と同じ設定手順で行えます。
            　　vmledit1.html , vmledit2.html は v1.2のものを v1.3のディレクトリに上書きコピーして構いません。
            　　vmledit3.html はバグ修正してありますので v1.3のファイルを使って下さい。
            
          
          
       3. お絵かきを含めたテスト投稿と削除が正常にできることを確認する。
          エラーが出た時は以下の点を確認・修正する
          
          1. ./vmlディレクトリのパーミッションが正しいか
          2. vmlno.cgi のパーミッションが正しいか
          3. ログファイル sunbbslog.cgi のパーミッションが正しいか
       
       ※この段階では以下の手順で旧バージョンの環境に戻すことができます。
       
       1. 「olddir」ディレクトリを「newdir」にリネームする
          
       2. 「oldbak」ディレクトリを「olddir」にリネームする
          
       3. 10. でファイルをリネームしていた場合は、それらを元の名前に戻す
          
    
    
    
    
13. 後処理
    
    動作確認に問題なかったらアップデート作業は終了です。以下の作業が可能です。
    
    
    • 下記のファイルは削除して問題ありません
      
      • update.cgi
      • conf_1_3.cgi
      
      
    • 旧バージョンのディレクトリ (例 :「oldbak」) は削除して問題ありません。
      バックアップデータは保管することをお勧めします。
      
      
    
    
    

オリジナル版からの移行について

• ※過去ログファイル(例:0001.dat,0002.dat)の保存形式には互換性がありません。
  　過去ログファイルを使わない設定(*)ではオリジナルデータをそのまま継続して使うことが出来ます。
  　オリジナル版からの移行ではなく、このスクリプトを新規で使う場合は過去ログを使用できます。
• 特にデータのバックアップを取るなど注意して行って下さい。