## Bulletin

#### このモジュールについて

ニュースモジュールのひとつです。newsの古いコードを刷新することが開発のきっかけとなりました。最終的に過去の有用なハックなどを盛り込み、Duplicatable機能も付け加えました。

#### 機能説明

- ニュース投稿・編集・削除
- アーカイブ
- RSS配信
- モジュールの複製( Dupulication V3 )
- newsの記事の取り込み
- 関連記事機能 new!!
- 同じカテゴリの最新記事一覧機能 new!!

#### newsからの変更点

- 各ファイルでassignされているテーマ変数から出来るだけHTMLタグを取り除いた。
- 各ファイルにおいてディレクトリ名を変更できるように改変した。
- 各ファイルでinclude から require に関数を交代した。
- $HTTP_*_VALUE を $_* に置き換えた。
- テンプレートを各PHPファイルの変更にあわせて改変した。
- テンプレートに<{strip}>タグを加えた。
- print.phpをテンプレート出力に対応した。
- 各ファイルにおいて，相対パスを絶対パスに変更した。
- print.phpにおける潜在的なtypoを訂正した。
- 「のこり***バイト」をマルチバイト環境に対応し，かつ「のこり**文字」に変更。
- 「分」の選択肢が 0~60 だったので 0~59 に修正。
- 記事投稿の日時選択フォーマット「月：mm 日：dd 年：YYYY 時：HH 分：ii」を，日本語式に「YYYY年mm月dd日HH時ii分」に変更した。
- アーカイブの表示方法を，スペースを有効活用するように変更した。
- archive.phpのSQL記述をclassへ移動した。
- ニュース投稿権限をグループごとに与えられる機能を追加した。（XOOPS2.0.4以降）
- ニュース投稿自動承認をグループごとで決められる機能を追加した。（XOOPS2.0.4以降）
- ユーザーのタイムゾーンが反映されない部分を修正した。
- DB項目の’story_type’を’type’に変更した。
- submit.phpにおける，本文フォームのサイズを一般設定で変更できる機能を追加した。
- コメントに記事の存在確認処理を追加。
- 検索結果の日時を投稿日時から掲載日時に変更した。
- 記事から画像がはみ出してしまうバグを修正。
- 記事の題名をサイトのタイトルに。
- article.phpにおける$storypageの妥当性を確認する処理を追加。
- 言語の名付け規則に従ってlanguageファイルを訂正した。（_NW_*→_MD_*）
- 本名もassignした。
- HTMLが有効なら改行を無効にした。
- クラスから出来る限りHTMLを追放した。→テンプレートへ。
- Ryujiさんのブロックを取り入れた。
- カレンダーブロックを追加。
- GIJOEさんのmyblockadminを取り入れた。
- 投稿数加算処理を改善。
- コメントブロックを追加した。
- 期限切れの記事が見られるバグ（仕様？）を修正。
- 記事の編集・管理の使い勝手を改善する。
- メールの文字化けは"Tell A Friend"に対応。
- ルートコントローラで配信していたRSSをモジュールの一部にした。→グループ設定が反映されるようになる。
- 複製可能にした。

ほかにも理解不能な仕様を改善したり、ずっと放置されていたっぽいバグFixをしたりといろいろ変わった点があります。

#### ToDo

- TinyDをまねて静的URLを生成するとか。
- トラックバック機能を追加してみるとか。
- ファイルアップ機能を追加したほうがいいか。
- 携帯電話端末対応は必須か。

#### 複製方法

Bulletinの複製機能はいわゆるDuplicatable V3です。

#### newsのデータベースとの差違

`storyid` int(8) unsigned NOT NULL auto_increment,
→変更無し
`uid` int(5) unsigned NOT NULL default '0',
→変更無し
`title` varchar(255) NOT NULL default '',
→変更無し
`created` int(10) unsigned NOT NULL default '0',
→変更無し
`published` int(10) unsigned NOT NULL default '0',
→変更無し
`expired` int(10) unsigned NOT NULL default '0',
→変更無し
`hostname` varchar(20) NOT NULL default '',
→変更無し
`html` tinyint(1) NOT NULL default '0',
→nohtmlだと否定が基本で認知的に非効率的なので、肯定に変更
`smiley` tinyint(1) NOT NULL default '0',
→nosmileyだと否定が基本で認知的に非効率的なので、肯定に変更
`br` tinyint(1) NOT NULL default '0',
→以前から必要だと言われていたので追加
`xcode` tinyint(1) NOT NULL default '0',
→なかったので追加
`hometext` text NOT NULL,
→変更無し
`bodytext` text NOT NULL,
→変更無し
`counter` int(8) unsigned NOT NULL default '0',
→変更無し
`topicid` smallint(4) unsigned NOT NULL default '1',
→変更無し
`ihome` tinyint(1) NOT NULL default '0',
→0と1を逆転
`notifypub` tinyint(1) NOT NULL default '0',
→削除
`type` tinyint(1) NOT NULL default '0',
→”story_type”だったもの。もはや必要のないもの。Bulletinでは承認/未承認の区別に利用
`topicimg` tinyint(1) NOT NULL default '0',
→”topicdisplay”,”topicalign”をひとまとめにして、数値で表すように変更。
`comments` smallint(5) unsigned NOT NULL default '0',
→変更無し

#### インストール方法

最初の１個をインストールする方法
(1) アーカイブを展開して、html/modules/bulletin を moduels の下にコピー
(2) ディレクトリ名は好きにつけてください。(例 mycompany)
(3) DocumentRootの外に専用のディレクトリを作ります (例 /home/yourhome/xoops_trust_path)
(4) そのディレクトリのフルパスをmainfile.phpに記述します。場所はXOOPS_URL定義行の直後が良いでしょう。
define('XOOPS_TRUST_PATH','/home/yourhome/xoops_trust_path');
（このステップ(3)と(4)は、最速キャッシュハックと同じです）
(5) XOOPS_TRUST_PATHの下にmodulesディレクトリを作ります (例 /home/yourhome/xoops_trust_path/modules)
(6) アーカイブのxoops_trust_path/modules/bulletinをXOOPS_TRUST_PATH/modules/にコピーします (例 /home/yourhome/xoops_trust_path/modules/bulletin)
(7) XOOPSモジュールとしてインストールしてください。
もう一個モジュールをインストールする方法
(1) アーカイブの html/modules/bulletin を moduels の下にコピー
(2) ディレクトリ名を好きにつけてください (例 mypolicy)
(5) XOOPSモジュールとしてインストールしてください。
モジュールをバージョンアップする方法
(1) アーカイブのxoops_trust_path/modules/bulletinをXOOPS_TRUST_PATH/modules/に上書きコピーします (例 /home/yourhome/xoops_trust_path/modules/bulletin)
(2) 必要に応じて、モジュールアップデートをかけます。
たったこれだけですべてのモジュールがアップデートされたことになります。
GIJOEさん、すみません。テキスト勝手に借りました…。

#### アンインストール方法

通常のモジュール同様にモジュール管理よりアンインストールを実行してください。

#### 更新履歴

Ver | Date | Category | Note
--- | --- | --- | ---
2.04 | 2006-08-19 | バグ | 未完成のテンプレートのためインストールが失敗するバグを修正。(thx kazu, plusangel)
2.03 | 2006-07-20 | バグ | モジュールのアイコンの色がおかしくなるバグを修正。(thx GIJOE)
2.03 | 2006-07-20 | 変更 | gticketをgticket2に変更。
2.03 | 2006-07-20 | 変更 | oninstall.php, update.php, onuninstall.phpのCube対応(thx GIJOE)
2.03 | 2006-07-20 | 変更 | RSSの<description>の文字数制限を削除。(thx GIJOE)
2.03 | 2006-07-20 | バグ | main/search.php、class/bulletingp.phpのショートタグを修正(thx GIJOE)
2.03 | 2006-07-20 | バグ | URLにスラッシュが抜けている部分を修正(thx fujisawa)
2.03 | 2006-07-20 | バグ | カテゴリのパンくず表示がでたらめになるバグを修正(thx jidaikobo)
2.03 | 2006-07-20 | バグ | カテゴリブロックでnewsの名残を修正(thx jidaikobo)
2.02 | 2006-07-09 | バグ | assingというtypoをassignに訂正(thx jidaikobo)
2.02 | 2006-07-09 | 変更 | 一般設定の日時フォーマットをブロックにも適用できるように変更(thx jidaikobo)
2.02 | 2006-07-07 | 言語 | Frenchを更新。(thx gigamaster)
2.01 | 2006-07-03 | バグ | Bulletin1からアップデートすると、ブロックのテンプレートが無効になるバグを修正。(thx plusangel)
2.01 | 2006-07-03 | バグ | main/search.phpで日本語の言語ファイルを無条件に読み込んでしまうバグ。(thx FutureSpy)
2.01 | 2006-07-03 | 追加 | 新規コメント投稿時のイベント通知機能。
2.01 | 2006-07-03 | 言語 | Englishを更新 (thx FutureSpy)
2.0 | 2006-06-25 | 変更 | 掲載の承認/非承認をチェックボックスでスイッチできるようにした。
2.0 | 2006-06-25 | 追加 | オプションに「ブロックに表示する」を追加。
2.0 | 2006-06-23 | 変更 | 文字カウント関数をより正確なものへ変更。
2.0 | 2006-06-23 | 変更 | item.htmlの<br clear="all" />を<div style="clear: both;"></div>に変更
2.0 | 2006-06-07 | 追加 | パンくずリストを追加。
2.0 | 2006-06-07 | 追加 | 同じカテゴリの最新記事を各記事の下に表示する機能を追加。
2.0 | 2006-06-07 | 追加 | 関連記事機能を追加。(ELFさんには大変感謝しています）
2.0 | 2006-06-07 | 変更 | RSSの出力に<content:encoded>タグを追加。
2.0 | 2006-06-07 | 変更 | 各テンプレートをロジックの変更に合わせて適宜変更。
2.0 | 2006-06-07 | 変更 | 管理画面とユーザ画面に分離していた記事投稿編集ページを統一。
2.0 | 2006-06-07 | 追加 | 権限による掲載日時のON/OFF設定を追加。
2.0 | 2006-06-07 | 変更 | 投稿フォームの本文１と本文２を一つのフォームに統一。
2.0 | 2006-06-07 | 変更 | alsysモジュールに対応。
2.0 | 2006-06-07 | 変更 | 一部、チケットシステムをGIJOEさんのものに変更。
2.0 | 2006-06-07 | バグ | その他小さなバグを修正。
1.05 | 2006-05-26 | バグ | イベント通知の「新規ニュース記事が掲載された場合に通知する」が機能していないバグを修正。
1.05 | 2006-05-26 | バグ | 複製したブリテンでイベント通知が正常に機能しないバグを修正。
1.042 | 2006-05-15 | バグ | 「最新ニュース」ブロックで「hometextを表示する件数」を指定している場合に、掲載期限が切れている記事が載ってしまうバグを修正。
1.041 | 2006-05-14 | バグ | ブロックで「残りX文字」が正しく表示されないバグを修正。
1.04 | 2006-05-12 | バグ | 期限切れ記事が20件以上閲覧できないバグを修正
1.04 | 2006-05-12 | バグ | カテゴリー別ブロックで「続きを読む」が表示されないバグを修正
1.04 | 2006-05-12 | バグ | RSSの表示不備を修正
1.03 | 2006-03-27 | バグ | コメント数のバグを修正
1.02 | 2006-02-26 | バグ | 複製したBulletinのブロックが正しく機能しないバグ。
1.02 | 2006-02-26 | 追加 | newsからインポートした後のページに「戻る」リンクを追加。
1.02 | 2006-02-26 | 言語 | englishを更新(thx Yuji)
1.02 | 2006-02-26 | 言語 | catalanを追加(thx Yuji)
1.02 | 2006-02-26 | 言語 | portuguesebrを追加(thx Yuji)
1.02 | 2006-02-26 | 言語 | spanishを追加(thx Yuji)
1.02 | 2006-02-26 | 言語 | frenchを追加(thx gigamaster)
1.02 | 2006-02-26 | 言語 | tchineseを追加(thx kiang)
1.01 | 2006-02-21 | 言語 | englishを追加(thx Yuji)
1.01 | 2006-02-20 | バグ | ブロックで件名の文字数切り詰めが出来ないバグを修正。
1.01 | 2006-02-20 | 追加 | Tell A Friendモジュールに対応。
1.01 | 2006-02-20 | 追加 | トピックを削除するとき、トピックに属する記事を他のトピックに移管できる機能を追加。
1.01 | 2006-02-20 | 追加 | 「印刷する」「友達に知らせる」アイコンの表示非表示を選択できるように変更。
1.01 | 2006-02-20 | 追加 | 「最新ニュース」で本文を複数表示できるように変更。
1.01 | 2006-02-20 | 追加 | RSSへのリンクを表示できるように変更。
1.01 | 2006-02-20 | バグ | [編集]がリンク切れしていたバグを修正。
1.01 | 2006-02-20 | 変更 | 「トピック」という表記を「カテゴリ」に統一した。
1.0 | 2006-02-16 | その他 | テスト版リリース

#### 謝辞

myblocksadminをGIJOEさんからお借りしました。<http://www.peak.ne.jp/>
gticketをGIJOEさんからお借りしました。
各言語ファイルを提供くださった皆様に感謝します。