こんにちわ。なおとです。

Shioriモジュールを使ってみることにしました。

それで簡単な説明と、気づいた点を書いていこうと思います。

概要

• モジュール名 Shiori(サイト内ブックマーク)
• ディレクトリ名 shiori
• バージョン 1.02
• モジュール説明 このモジュールはサイト内のページをブックマークするためのモジュールです。
• モジュール作者 Suinさん http://suin.asia/

いわゆるXOOPS2時代に開発されていた、栞(最終バージョン 0.51)の後継版です。 すっかり作り替えたそうです。

PHPのバージョンがある程度より古いと、動作しない(サポート外)ようです。 PHP 5.2.4 以上 (mbstring 必須)。

ダウンロードしました

Shiori 1.02 | スイナシア (説明、 「shiori」なエントリー)

インストール

さっそく付属の説明書を確認しました。

readme_ja.html という名前のファイルです。 配布元のサイト以上に、詳しいことが書いてあるようです。 以後はこれを読んで、その内容のまま進めてみます。

インストール手順はごくオーソドックスで、モジュールのインストールに慣れた方であれば、悩むことはないでしょう。 そのあたりはちょと端折って説明します。

インストールの最初は、サーバーにファイルを配置しました。

管理画面の「モジュールのインストール」で、インストールしました。

また説明の通りに、ブロックのインストールと権限の設定もしました。

ここまでで、基本的な機能が使えるようになりました。

カスタマイズなど

説明書にある動画を見ました

Shioriモジュールのワンクリックブックマーク機能 | スイナシア

★型のアイコンをクリックすると、そのアイコンがくるくる回る画像になって、ブックマークできる様子が見えます。 これに挑戦しました。

説明書の通りに、ユーザーメニューを修正しました。

詳しいことは省きますが、残念ながらこれだけでは、動画のような動きにはなりませんでした。

変更1：ブロックのテンプレートを変えました

スタイルシートで非表示になっているので、それを解除します。

修正するファイル 互換モジュール
legacy_block_usermenu.html

修正前(説明書にある追加部分)

<a href="<{$xoops_url}>/modules/shiori/"><img src="<{$xoops_url}>/modules/shiori/images/unbookmarked.png" id="shiori_bookmark_star" style="float:right;display:none;" rel="<{$xoops_url}>" />Bookmark</a>

修正後(スタイルシートを修正)

<a href="<{$xoops_url}>/modules/shiori/"><img src="<{$xoops_url}>/modules/shiori/images/unbookmarked.png" id="shiori_bookmark_star" style="float:right;" rel="<{$xoops_url}>" />Bookmark</a>

注意点：テーマによっては、サーバーのファイルを修正する必要があります

大抵のケースでは、テンプレートの修正はALTSYSを使うと便利です。 管理者メニューから、書き換えたいテンプレートを編集できます。

しかし使っているテーマによっては、その方法が通用しません。 「hd_default」がこれに該当します。 「テーマ下テンプレート」と言われる仕組みでテンプレートを管理しているので、それを書き換える必要があるのです。

しかも、全てのテンプレートがテーマ下テンプレートになる訳ではなくて、hd_defaultに同梱されていた(＋自身で追加した)テンプレートだけがそのようになります。 この条件に合ってないテンプレートは、いつものように、ALTSYSで編集できます。

修正するファイル
html/themes/hd_default/templates/legacy_block_usermenu.html

変更2：画像のパーミッションを変えました

これは、大抵のひとには問題にならないと思われます。

問題となるのは、サーバーの中でZIPファイルを直接展開しているなどで、 ZIPファイルが作成された時のパーミッションをそのまま引き継いだ場合です。

これを修正しました。

html/modules/shiori/images/ の中の画像ファイルは全て、「644」にします。

サイト名は省きたい

ブックマークには名前(ページ名)が付くのですが、それにサイト名も一緒に入っていて、これは変えたいと思いました。 どうやらこの文字列は、title要素のテキスト(ブラウザのタイトルバーに表示されている)が使われるようです。

この部分はテンプレートの修正で対応可能です。 こちらはALTSYSで編集しました。

管理者メニューでALTSYSの管理画面を開き、さらに「テンプレートの管理」というサブメニューを辿って、Shioriモジュールのテンプレートを見付けます。

修正するテンプレート Shioriモジュール
shiori_block_bookmark.tpl

修正前(テンプレートの最後のほう)

document.write('<input type="hidden" name="title" value="' + document.title + '" />');

修正後(repleceを追加)

document.write('<input type="hidden" name="title" value="' + document.title.replace('XOOPS Cube Site - ', '') + '" />');

「XOOPS Cube Site - 」の部分は、サイト名＋「(スペース)(マイナス)(スペース)」です。 もしこのブログ記事を読んで同じことする場合は、各自のサイトで使っているサイト名を当てはめます。 これで、サイト内のブックマークではサイト名が付かないようになりました。

一般設定の説明

おまけです。

• 項目名 (初期値)
• ブックマークの最大保存件数 (30)
• 1ページ当たりに表示するブックマークの件数 (30)
• URLを入力して登録できるようにする (いいえ)
• 外部のサイトへのブックマークを許可する (いいえ)

「ブックマークの最大保存件数」は、各ユーザーが一人でブックマークできる件数でした。

「1ページ当たりに表示するブックマークの件数」は、Shioriの画面でブックマーク一覧を見るとき、に使われる設定になっています。

以上です。