1. イベント編集画面を開く

ページ編集画面で「Event」をクリックしてイベント編集画面を開きます。

2. ユーザー定義関数を追加する（１）

Method欄の「+Add」をクリックしてユーザー定義関数を追加します。

3. ユーザー定義関数を追加する（２）

function欄に関数名、Comment欄に関数の説明を入力し、Enable（有効）を選択します。
サンプル画像では、関数名を「amount」、関数の説明を「税込み価格を計算する」としています。

4. ユーザー定義関数を編集する

Web Studioでは関数呼び出し時に渡された引数は、次のようにfunc_get_arg()を使用して変数に展開します。

$price = func_get_arg(0);
$tax = func_get_arg(1);
$count = func_get_arg(2);

$unit = $price + ($price * $tax / 100);
return $unit * $count;

「Save」ボタンをクリックすると.classファイルが作成され下記のコードが書き出されます。

/**
 * 税込み価格を計算する
 */
function amount() {
  $price = func_get_arg(0);
  $tax = func_get_arg(1);
  $count = func_get_arg(2);
  
  $unit = $price + ($price * $tax / 100);
  return $unit * $count;
}

例えば、「index.html」ページのイベントを編集すると、「index.html.class」という名称のファイルが作成されます。　.htmlと.classは対になっており、.classをページクラスと呼びます。


＜禁止事項＞

Web Studioでは、ユーザー定義関数の編集画面に直接function構文を記述しないでください。

function amount2($price, $tax, $count) {
  $unit = $price + ($price * $tax / 100);
  return $unit * $count;
}

この場合、フレームワークによって下記のコードが生成されてしまいます。
現在のPHPバージョンでは、関数の中に関数を記述してもエラーにはなりませんが、煩雑なコードとなりますのでやめましょう。

function amount() {
  function amount2($price, $tax, $count) {
    $unit = $price + ($price * $tax / 100);
    return $unit * $count;
  }
}

5. ユーザー定義関数を使用する

ユーザー定義関数を追加したページのページ編集画面を開き、エディター内の任意の箇所に、下記のコードを入力してみましょう。

<div class="test">

 合計：<?= $page->amount(2000, 10, 2) ?>円

</div>

$page->は、ページクラスを指します。
ページクラスに追加したamount関数を呼び出すという意味になります。

<?=　?>は、ショートエコータグと言い、PHP開始タグ、PHP終了タグとecho文を短く記述したもので、下記の記述と同等です。　HTMLタグ内に単一の文字列を出力したい場合は、ショートタグで記述しましょう。

<div class="test">

 合計：<?php echo $page->amount(2000, 10, 2); ?>円

</div>

本章では、Web Studioでの関数の作成方法と使用方法を学習しました。
イベント編集画面に、いろんな関数を追加して動作を確認してみましょう。