• このアプリケーションについて
• メールを配信する
• サーバの設定を行う
• 予約ジョブ配信について
• SOY CMSとの連携
  • 登録フォーム、解除フォームの表示
  • SOYAppページの基本テンプレート
  • 属性の変更

SOY Mailはメール配信を行うアプリケーションです。
SOY CMSと連携してユーザ登録・解除を行います。

メール配信は「即時配信」と「予約配信」があります。

メールはメールの作成から作成し、[送信]ボタンを押すことで 送信トレイに入ります。

送信トレイに入ったメールは予約が設定されていれば予約ジョブによって配信されます。
また、送信メールトレイから[配信]を押すことで 即時に配信されます。

サーバの設定からお使いのメールサーバに 合わせた設定を行ってください。

受信設定はPOP設定を行うと、受信されたメールはサーバから削除されてしまう場合があることに注意してください。
受信設定はエラーメールの感知に使用されます。

予約ジョブ配信はサーバのcrontabを使用して実行します。
以下のパスをcrontabで登録してください。

例) /usr/local/bin/php 1> /dev/null 2> /dev/null

メール送信に実行権限の問題などが無いか、crontabの設定後、実際の送信を行う前に必ず動作確認を行ってください。

SOY CMSで管理されているサイト上に登録フォームを設置できます。
ページの新規作成からページの種類に「SOY Appページ」を選択して下さい。

SOY AppページはSOY CMSの基本機能(ブロック、プラグイン）も使えます。

テンプレートを変更することで、デザインや表示するメッセージを変更できます。

基本テンプレートをカスタマイズして使用して下さい。
SOY MailのSOY Appページは以下の特殊なタグを記述することで動作します。

register_form

登録フォームを表示します

unregister_form

解除フォームを表示します

register_message

登録後メッセージを表示します。

unregister_message

解除後メッセージを表示します。

SOYAppページの基本テンプレートを表示します。
コピーアンドペーストして、ご使用ください。

<!-- app:id="register_form" -->
<div>
	<h1>登録フォーム</h1>

	<!-- 入力内容に間違いがあった場合のみ表示されます -->
	<p cms:id="error_message">入力内容に誤りがあります</p>

	<p>メールアドレスを入力して、[登録]を押してください</p>

	<input cms:id="mailaddress" />
	<input type="submit" value="登録">
</div>
<!-- /app:id="register_form" -->

<!-- app:id="register_message" -->
<p>ご登録ありがとうございました。下記のメールアドレスを登録いたしました。</p>
	<p cms:id="mailaddress">ここに入力されたメールアドレスが入ります</p>
<!-- /app:id="register_message" -->

<!-- app:id="unregister_form" -->
<div>
	<h1>解除フォーム</h1>

	<p>メールアドレスを入力して、[解除]を押してください</p>

	<input cms:id="mailaddress" />
	<input type="submit" value="解除">
</div>
<!-- /app:id="unregister_form" -->

<!-- app:id="unregister_message" -->
<p>下記のメールアドレスの登録を解除いたしました。</p>
	<p cms:id="mailaddress">ここに入力されたメールアドレスが入ります</p>
<!-- /app:id="unregister_message" -->

応用例として、複数の登録フォームそれぞれについて、登録時に異なる 属性を切り替えて保存する手法を解説します。

例えば、あるSOYAppページで登録した場合は属性１に「PC」と入る様に設定したい 場合、次のようにテンプレートに記述します。

<!-- app:id="register_form" -->
<div>
	<h1>登録フォーム</h1>

	<p>メールアドレスを入力して、[登録]を押してください</p>

	<input cms:id="mailaddress" />
	<input type="hidden" name="attribute1" value="PC" />
	<input type="submit" value="登録">
</div>
<!-- /app:id="register_form" -->

inputの名前(name)を「attribute2」にすれば属性2を、「attribute3」にすれば属性3を設定できます。

また、種別(type)を「hidden」から「text」にすることでユーザに入力してもらうことも出来ます。