ユーザーマクロを書く

ユーザー マクロを作成する

新しいユーザー マクロを追加するには:

1. 移動 

   Error rendering macro 'excerpt-include'

   ユーザー 'null' にはこのページを表示する権限がありません。

    > User Macros
2. ユーザー マクロの作成を選択します。
3. マクロの詳細を入力します (以下の表を参照)。
4. 追加をクリックします

ユーザー マクロを編集する

ユーザー マクロを編集するには

1. 移動 

   Error rendering macro 'excerpt-include'

   ユーザー 'null' にはこのページを表示する権限がありません。

    > User Macros
2. 関連マクロの隣にある 編集 をクリックします。
3. マクロの詳細を更新する
4. 保存 をクリックします。

ユーザー マクロの削除

ユーザー マクロを削除するには:

1. 移動 

   Error rendering macro 'excerpt-include'

   ユーザー 'null' にはこのページを表示する権限がありません。

    > User Macros
2. 現在設定されているユーザー マクロが表示されます
3. 関連するマクロの横にある 削除 をクリックします。

ユーザー マクロを削除する前に、ページやブログ投稿でのそのマクロの使用箇所をすべて 検索 する必要があります。ページ上でまだ使用されているユーザー マクロを削除すると、ユーザーに「不明なマクロ」エラーが表示されます。  

べスト プラクティス

このセクションには、独自のユーザー マクロを作成する際のベストプラクティスに関するヒントや提案が含まれています。

マクロ ヘッダーに説明的なヘッダーを追加する

テンプレート フィールドの一番上に、以下の用にコメントとして短い説明を含めることをお勧めします。 

## Macro title: My macro name
## Macro has a body: Y or N
## Body processing: Selected body processing option
## Output: Selected output option
##
## Developed by: My Name
## Date created: dd/mm/yyyy
## Confluence version: Version it was developed for
## Installed by: My Name

## Short description of what the macro does

マクロ ブラウザーにパラメーターを表示する

ユーザーがマクロを構成する最も簡単な方法はマクロ ブラウザーです。ユーザーはマクロ カテゴリーを指定、アイコンへリンク、およびマクロ ブラウザーがユーザーに情報を要求するために使用するパラメーターを定義するなどを行うことができます。

マクロ パラメーターのデフォルトの値を供給する

ユーザーがパラメーターを指定したかどうかはわからないため、マクロ コードで後から依存する予定がある場合、最初に、マクロで一部の値を受け取ったかどうかを確認する必要があります。

以下の例では、マクロは 3 つのパラメーターを期待し、指定されない場合は実用的な既定値に置き換えられます。

#set($spacekey= $paramspacekey)
#set($numthreads= $paramnumthreads)
#set($numchars= $paramnumchars)

## Check for valid space key, otherwise use current
#if (!$spacekey)
  #set ($spacekey=$space.key)
#end

## Check for valid number of threads, otherwise use default of 5
#if (!$numthreads)
  #set ($numthreads=5)
#end

## Check for valid excerpt size, otherwise use default of 35
#if (!$numchars)
  #set ($numchars=35)
#end

セキュリティへの影響を考慮する

また、ユーザーが表示権限を持っていないコンテンツを誤って表示してしまうのを防ぐため、制約付きのページやスペース権限など、多数の権限シナリオでユーザー マクロを徹底的にテストすることをお勧めします。詳細については、「ユーザー マクロ テンプレート構文」を参照してください。 

ユーザー マクロの例

## @noparams
Hello World!
$body

## @noparams
<div class="aui-message closeable">
Hello World!
$body
</div>

## @noparams
<div class="noprint">$body</div>

## @param 0:title=colour|type=string
## @param 1:title=size|type=string
<span style="color: $param0; font-size: $param1">$body</span>

## @param Colour:title=colour|type=string
## @param Size:title=size|type=string
<span style="color: $paramColour; font-size: $paramSize">$body</span>

## @param Title:title=Title|type=string|desc=Title
<ac:structured-macro ac:name="panel">
        <ac:parameter ac:name="titleBGColor">#ccc</ac:parameter>
        <ac:parameter ac:name="borderStyle">solid</ac:parameter>
        <ac:parameter ac:name="borderColor">#6699CC</ac:parameter>
        <ac:parameter ac:name="borderWidth">2</ac:parameter>
        <ac:parameter ac:name="titleColor">#000000</ac:parameter>
    <ac:parameter ac:name="title">$!paramTitle</ac:parameter>
    <ac:rich-text-body>$body</ac:rich-text-body>
</ac:structured-macro>

## @param Title:title=Title|type=string|desc=Title

title=Title

type=string

desc=Title

<ac:structured-macro ac:name="panel">

<ac:parameter ac:name="titleBGColor">#ccc</ac:parameter>
<ac:parameter ac:name="borderStyle">solid</ac:parameter>
<ac:parameter ac:name="borderColor">#6699CC</ac:parameter>
<ac:parameter ac:name="borderWidth">2</ac:parameter>
<ac:parameter ac:name="titleColor">#000000</ac:parameter>

<ac:parameter ac:name="title">$!paramTitle</ac:parameter>

<ac:rich-text-body>$body</ac:rich-text-body>

</ac:structured-macro>

次のステップ

ユーザー マクロの力をさらに詳しく調べるには、「高度なユーザー マクロを記述する」ガイドを参照してください。