

【添付ファイルアドオンの設置手順を解説いたします】


0、まずアドオンファイルを使用する前に、zipファイルを丸ごとコピーして片方をバックアップ保存しておくことをおすすめいたします。




1、zipファイルを展開します。




2、メールフォーム本体にあるaddonフォルダの中に、attachmentフォルダを入れます。




3、メールフォーム本体のindex.htmlに以下の2つのコードを追加します。( index.htmlを、attachmentフォルダの中のindex(差し替え用).htmlと差し替えるだけでもOKです )
	
	
	3-1、index.htmlのhead要素内に、以下のようにattachment.cssの読み込みを追加。
	
<link rel="stylesheet" href="addon/attachment/attachment.css" />
	
	
	
	3-2、index.htmlのform要素内のdl要素の中に、以下のようにファイル添付用のdl,dt,dd要素を追加。( MAX_FILE_SIZEのinput要素は画面に表示されませんが必須です )
	
<dl>
	<dt><i></i>添付ファイル(複数選択NG)</dt>
	<dd>
		<ul>
			<li><input type="hidden" class="max_file_size" name="MAX_FILE_SIZE" value="" /></li>
			<li><input type="file" name="attachment[]" /></li>
			<li><input type="file" name="attachment[]" /></li>
			<li><input type="file" name="attachment[]" /></li>
			<li><input type="file" name="attachment[]" /></li>
			<li><input type="file" name="attachment[]" /></li>
			<li><input type="file" name="attachment[]" /></li>
		</ul>
	</dd>
</dl>
	
	上のHTMLコードは1つのボタンにつき、1つのファイルを選択できるタイプとなります。
	それに対し、下のHTMLコードでは1つのボタンで複数のファイルを選択することができます。( multiple="multiple"が追加されています )
	
<dl>
	<dt><i></i>添付ファイル2(複数選択OK)</dt>
	<dd>
		<ul>
			<li><input type="hidden" class="max_file_size" name="MAX_FILE_SIZE" value="" /></li>
			<li><input type="file" name="attachment_2[]" multiple="multiple" /></li>
		</ul>
	</dd>
</dl>




4、attachment-config.phpを開き、アップロードできるファイルサイズの上限を記入します。

$rm_upload_max_size = 2000000;

初期状態である上のコードでは2000000バイト、つまり1つのファイルにつき約2MBまでが選択可能となります。




5、attachment-config.phpを開き、送信可能なファイル形式を記入します。

$rm_jpg = 1;
$rm_png = 1;
$rm_gif = 1;
$rm_zip = 0;
$rm_pdf = 0;
$rm_doc = 0;
$rm_xls = 0;

初期状態である上のコードではJPG、PNG、GIFファイルを許可し、ZIP、PDF、DOCX(DOC)、XLSX(XLS)ファイルを不許可としています。
補足：WordファイルはDOCX(DOC)、EXCELファイルはXLSX(XLS)です。




設置は以上です。
実際にメールフォームに入力・ファイル指定をしてみて、ファイルが送信されるかを確認してみましょう。








【補足説明】

添付ファイル機能というものは攻撃の的となりやすい面があります。
例えば、容量の重いファイルを送ることでサーバをダウンさせたり、ウイルスを仕込んだ実行ファイルを送りつけたりすることもできます。
添付ファイル機能はセキュリティ面でのリスクが増し、サーバにかかる負荷も増えるため、正確に、そして厳しめに設定をするほうが無難です。








【ファイル選択ボタン( input type=”file” )の追加や削除について】

MAX_FILE_SIZEのinput要素は必須です。これのname属性とvalue属性も必須で変更不可です。
つまり、以下のコードは一切触らずに残しておいてください。
<input type="hidden" class="max_file_size" name="MAX_FILE_SIZE" value="" />

ファイル選択ボタン( input type=”file” )は初期状態では6つ並んでいますが、この「6つ」という数に意味はありません。自由に増やしたり減らしたりしてください。

また、dl,dt,dd要素ごと増やしていくことも可能です。
その場合は、各グループごとのname属性はそのページ内で同一のものが存在しないよう唯一の名前にしてください。
これはこのプログラムの仕様というより、HTMLの仕様です。

そして、name属性は同一の選択肢グループに属するものは同じname属性名にし、末尾に[]を追加してください。

このあたりはチェックボックスを増やす場合と同じ仕様となっておりますので、「メールフォームの項目を増やす方法」のページを参考にしてください。
https://www.1-firststep.com/archives/1433#link-scroll-6








【アドオンのアップデートについて】

メールフォーム本体とアドオンは適合するバージョンというものがあります。
どのバージョンが合うかは、各アドオン販売ページの一番下にある「アップデート履歴」でご確認ください。
(現在お使いのアドオンのバージョンはアドオンフォルダの中にある「version.php」に記載してあります。)

ですので、もしアドオン購入後にメールフォーム本体をアップデートさせると、アドオンが古いバージョンのままのせいで正常動作しなくなる場合があります。

過去にアドオンを購入された方からご要望があれば、新しいバージョンのアドオンファイル一式をお送りいたしますので、配布依頼ページからお求めください。
その際には、現在お持ちのアドオンファイル一式をメール添付して私にお送りいただくことで、過去に購入したことの証明とさせていだきます。








【サポートについて】

有料販売しているアドオンには設置メールサポートが付いています。
設置方法でご不明な点があったり、カスタマイズしていない初期状態なのに正常動作しないような場合は、以下のページからお問い合わせください。
https://www.1-firststep.com/contact/inquiry

注意：設置メールサポートは「アドオンの設置」に関しての質問のみとなります。
カスタマイズに関してのご質問などは別途料金が発生いたしますので、ご了承ください。




-----------------------------------------------------------------------------------

　　FIRSTSTEP -ファーストステップ- / 谷 元博
　　〒444-0840 愛知県岡崎市戸崎町才苗８番地１１
　　0564-74-0457
　　https://www.1-firststep.com

-----------------------------------------------------------------------------------








