#####################################
#                                   #
#   fsearch ver.4.3.1               #
#   設置の仕方と使い方              #
#                                   #
#####################################

========================================================================================
◇ 設置の仕方
========================================================================================

１.ダウンロードしたファイルを解凍してください。fsearchフォルダができます。
   fsearchフォルダのフォルダ名は自由に変更してもらって構いません。

２.fsearchフォルダごとそのままサーバーにアップロードして、
   ブラウザでhttp://xxx.xxx.xxx/fsearch/php/admin.phpなどと入力して(xxx.xxx.xxxの部分はあなたのサイトのURL)、
   admin.phpにアクセスします。
   パスワード入力画面がでれば設置完了です。
   パスワードにadminと入力して「ログイン」をクリックすると管理画面に入れます。

３.管理画面に入ると「機能の選択」ページになります。
   まずは「カテゴリの設定」をクリックして、カテゴリを登録します。
   カテゴリの登録の仕方は、まず一番上の階層のカテゴリを追加します。
  「大カテゴリの追加」をクリックすると「追加数」のフォームがでますので、
   数字を選択するとその数だけ入力フォームが下に追加されますので、「カテゴリ名」に入力して「送信」を押すと、
   一番上の階層のカテゴリが登録されます。「説明」については入力してもしなくてもいいです。
   子カテゴリを登録するときは、親となるカテゴリの右側の「追加」のリンクをクリックすると「追加数」のフォームがでますので、
   数字を選択するとその数だけ入力フォームが下に追加されますので、それに入力して「送信」を押すと、
   親カテゴリの下に子カテゴリが追加されます。

   マークについては、カテゴリと同じように「マーク追加」をクリックして「追加数」で数を選択するとフォームが
   でますので、入力してください。

４.ブラウザでhttp://xxx.xxx.xxx/fsearch/php/index.phpとアクセスすると、
   トップページが表示されます。サイトを登録するカテゴリのリンクをクリックして、「このカテゴリに新規登録」
   をクリックしてフォームに入力してサイトを適当に入力して、サイトを登録してみてください。

５.http://xxx.xxx.xxx/fsearch/php/index.phpにアクセスして、
   サイトを登録したカテゴリのリンクをクリックして本登録したサイトが表示されるか確認してください。

６.実際はindex.phpではなく、ホームページのindex.htmlにリンクを張ってカテゴリを表示する場合が
   ほとんどだと思いますので、その場合は管理画面の「カテゴリの設定」にカテゴリIDが表示されていますので、
   index.htmlに<a href="fsearch/php/main.php?mode=search&ct=01_01">パソコン</a>
   のようにリンクを張ってください。
   マークについては、同じように管理画面にマークのIDが表示されていますので、
   <a href="fsearch/php/main.php?mode=mark&m=01">相互リンク</a>
   のようなリンクを張ってください。もちろん、index.phpをサイトのトップページにしてもいいです。

７.管理画面の「環境設定」で「サイトのURL」と「ホームページ名」を設定すると、
   各ページにホームページ ＞ カテゴリ名のようにリンクが張られます。
   必要であれば設定してください。
   

========================================================================================
◇ スキンについて
========================================================================================

デザインを変更するときはskinフォルダの中にスキンのHTMLファイルが入っていますので、
これを変更してください。
<!--category-->のようなコメントタグや、
#ctのような#のついた文字を変更しなければ動くと思います。

common.htmlが全体を表示するスキンで、この<!--contents-->の部分に他のスキンのタグが表示されます。

========================================================================================
◇ SNSのアイコンについて
========================================================================================

サイト登録のときに
各SNSのURLを入力すればアイコンが表示されます。
アイコン画像についてはimgフォルダに入れていますが、
ファイル名が同じであればいいので自由にお好みのものに変更してください。
SNSのアイコンについては各SNSごとに規約があるので注意が必要ですが、
最小サイズがPCは20px、携帯は40pxで上下左右共に画像の半分以上のマージンを取れば問題無いようです。
各SNSのアイコンのダウンロードページと規約は以下になります。

X
https://about.twitter.com/en/who-we-are/brand-toolkit

Facebook
https://about.meta.com/ja/brand/resources/facebook/logo/

Instagram
https://about.meta.com/ja/brand/resources/instagram/instagram-brand/

LINE
https://line.me/ja/logo

Facebookの代わりにYouTubeのアイコンを使いたいときは
php/lib/conf_fixed.phpの
$sns=array(
"1"=>'Facebook',
"2"=>'Instagram',
"3"=>'Twitter',
"4"=>'LINE',
);
この部分を

$sns=array(
"1"=>'Youtube',
"2"=>'Instagram',
"3"=>'Twitter',
"4"=>'LINE',
);
と変更して

imgフォルダのsns1.gifを
youtubeのアイコンに変更してください。

========================================================================================
◇ 検索語(タグ)について
========================================================================================

管理画面の「環境設定」の
「検索語(タグ)の記録」をオンにするとユーザーの検索語を記録して表示します。
common.htmlの
<!--tags-->
この部分に表示します。
検索語を記録されることを敬遠するユーザーもいると思いますので
この機能をオンにするときは注意してください。

========================================================================================
◇ アクセスランキングについて
========================================================================================

アクセスランキングを実施するときは、
相手のホームページに
<a href="http://xxx.xxx.xxx/fsearch/php/main.php?mode=rank_access&id=登録者のID">ホームページ名</a>
のようなリンクを張ってもらってください。
xxx.xxx.xxxのところはあなたのサイトのURLになります。

========================================================================================
◇ データベースについて
========================================================================================

データベースを初期化するときは、
管理画面の「機能の選択」ページの「データベース」をクリックして
「初期化」をクリックしてください。
初期化するとすべてのデータが失われますので注意してください。

========================================================================================
◇ CSVのダウンロードとアップロードについて
========================================================================================

管理画面の「機能の選択」ページの下に
「ダウンロード」というリンクがありますが、これをクリックすると全データが
CSVファイルでダウンロードできます。
「アップロード」をクリックするとアップロードフォームがでますが、
ダウンロードしたCSVファイルをアップロードして全データを登録できます。
アップロードする前にデータベースの初期化を行う必要はありません。

========================================================================================
◇ バージョンアップについて
========================================================================================

ver.3からver.4にバージョンアップするときは、
ver.4を設置したあと、
http://cgipal.com/script/ext/fs_henkan_3_4.zip
こちらをダウンロードして解凍したfs_henkan_3_4.phpを
ver.3のadmin.phpと同じ階層にアップして、
fs_henkan_3_4.phpにブラウザでアクセスすると
「ver.4形式でダウンロード」というボタンがありますのでそれをクリックすると
ver.4形式のCSVファイルがダウンロードできますので、
それをver.4の「機能の選択」ページの下の「アップロード」リンクをクリックしてアップしてください。

========================================================================================
◇ メール送信について
========================================================================================

管理画面の「環境設定」にメールの設定がありますので、そこで
送信の設定ができます。
メールのテンプレートの
_name
などが
名前などに変換されます。
必要であればテンプレートを編集してください。
_nameなどについては不要なものは削除してかまいませんが、
_を取ったりすると表示されなくなります。

========================================================================================
◇ PHPのバージョンについて
========================================================================================

PHP7と8で動作確認していますので
サーバーのPHPが7以上であれば問題なく動くと思いますが、
サーバーのPHPが5の場合がありますので
その場合はPHP7以上に変更できる場合は変更してください。
(できれば8が望ましいです)
5では動作しないです。

========================================================================================
◇ ファイルの説明
========================================================================================

fsearch/
      |
      +--css/(スタイルシートファイルのディレクトリ)
      |      |
      |      +--style.css(スタイルシート)
      |
      +--js/(JavaScriptファイルのディレクトリ)
      |      |--captcha.js(CAPTCHA用)
      |      |--form.js(入力チェック用)
      |      |--md5.js(CAPTCHA用)
      |      +--var.js(JavaScriptの変数記録用)
      |
      +--img/ (画像ディレクトリ)
      |
      +--php/ (PHPファイル、ログファイルのディレクトリ)
      |      |-- main.php(メインスクリプト)
      |      |-- admin.php(管理画面のスクリプト)
      |      |-- index.php(トップページ表示用のスクリプト)
      |      |
      |      +--lib/ (機能ファイルのディレクトリ)
      |      |     |-- .htaccess(アクセス制限用ファイル)
      |      |     |-- conf_fixed.php(設定用ファイル 変更は手動)
      |      |     |-- conf_common.php(設定用ファイル 変更は管理画面)
      |      |     |-- conf_cate.php(カテゴリ設定ファイル 変更は管理画面)
      |      |     |-- db_sqlite.php(データベース操作用)
      |      |     |-- db_fields.php(データベース操作用)
      |      |     |-- funt.php(機能をまとめたファイル)
      |      |     |-- rank.php(ランキング記録用)
      |      |     |-- sites.php(ユーザーによるデータ登録用)
      |      |     |-- search.php(検索用)
      |      |     |-- passwd.php(パスワード記録用)
      |      |     |
      |      |     +-- admin/ (管理用ファイル)
      |      |     |        |-- adregist.php(データ登録用)
      |      |     |        |-- category.php(カテゴリ登録用)
      |      |     |        |-- csv.php(データのアップロードとダウンロード用)
      |      |     |        |-- linkcheck.php(リンクチェック用)
      |      |     |        |-- set.php(環境設定用)
      |      |     |        +-- adsite.php(登録サイト編集用)
      |      |     |
      |      |     +-- template_mail/ (メールのテンプレート)
      |      |                      |-- touser_del.txt(削除時のメール)
      |      |                      |-- touser_edit.txt(編集のメール)
      |      |                      |-- touser_hon.txt(本登録のメール)
      |      |                      +-- touser_temp.txt(仮登録のメール)
      |      |
      |      +--log/ (ログファイルのディレクトリ)
      |            |-- .htaccess(アクセス制限用ファイル)
      |            |-- tags.log(タグ記録用)
      |            |-- tmp.log(仮登録記録用)
      |            |-- tmp2.log(一時保管記録用)
      |            |-- tmp3.csv(アップロード登録用)
      |            |
      |            +-- db/ (データベースファイル)
      |                  |-- access.db(アクセスランキング用ログ)
      |                  |-- data.db(データ記録用ファイル)
      |                  +-- jump.db(人気ランキング用ファイル)
      |
      +--skin/ (スキンの入ったディレクトリ)
             |-- common.html(共通のスキン)
             |-- confirm.html(登録確認用スキン)
             |-- form.html(登録フォーム用スキン)
             |-- inform.html(通知用スキン)
             |-- inform_thanks.html(通知用完了スキン)
             |-- login.html(ログイン用スキン)
             |-- search.html(検索用スキン)
             +-- thanks.html(登録・削除完了用スキン)
             

========================================================================================
◇ パーミッションついて
========================================================================================

パーミッションは特に設定しなくても動くと思いますが、
動作確認中に
ERRORSQLSTATE[HY000]: General error: 8 attempt to write a readonly database
あるいは
ERRORSQLSTATE[HY000]: General error: 14 unable to open database file
のようなエラーや、あるいは
～に書き込めません。パーミッションなどを確認してください。
のようなエラーが出た場合は、PHPがユーザー権限で動いていないサーバーです。
その場合は以下のようにファイルとディレクトリのパーミッションを以下のように変更してみてください。
[]内がパーミッション

var.js [606]
lib/conf_common.php [606]
lib/passwd.php [606]
lib/template_mail/touser_del.txt [606]
lib/template_mail/touser_edit.txt [606]
lib/template_mail/touser_hon.txt [606]
lib/template_mail/touser_temp.txt [606]
log/tags.log [606]
log/tmp.log [606]
log/tmp2.log [606]
log/tmp3.log [606]
log/db/ [707]
log/db/access.db [606]
log/db/data.db [606]
log/db/jump.db [606]

========================================================================================
◇ クッキーついて
========================================================================================

管理画面にログインするときに
クッキーのチェックを入れておくとパスワードをクッキーに保存して
次回からはそれを表示しますので入力の手間が省けます。
クッキーを削除するときはパスワードの入力は空のままクッキーにチェックを入れて
「ログイン」をクリックしてください。

========================================================================================
◇ CAPTCHAについて
========================================================================================

文字の入力(CAPTCHA)を行わないときは
管理画面の
文字の入力(CAPTCHA)
を「文字を入力してもらうようにしない」
に設定してださい。初期状態ではそのようになっています。
その場合、
skin/form.htmlの
<!--capt-->
<tr>
	<th>文字の入力<span class="r">＊</span></th>
	<td>
		
		<input type="hidden" id="key" name="key">
		<canvas id="captcha"></canvas>
		<input type="button" value="別の文字" id="refresh" onclick="Captcha()"><br>
		<input type="text" name="ans" size="6"> 表示されている文字を入力してください。
		<script src="../js/md5.js"></script>
		<script src="../js/captcha.js"></script>
	</td>
</tr>
<!--/capt-->
この部分と
php/lib/sites.phpの
314行の
$skinline=preg_replace("/<!--capt-->.*?<!--\/capt-->/s","",$skinline,1);
と
319行の
$skinline=preg_replace("/<!--capt-->.*?<!--\/capt-->/s","",$skinline,1);
は不要なので削除してもいいです。
少しは軽くなると思います。


========================================================================================
◇ 著作権表示について
========================================================================================

common.htmlのHTMLソースの一番下に
<!--http://www.cgipal.com-->
と記入しています。
これは削除してはいけません。箇所は移動してもいいです。
