OctureCMSプラグインの開(kāi)発：Google Analyticsの例

OctureCMSは急速に成長(zhǎng)しているコンテンツ管理システム（CMS）であり、すべてのCMSプラットフォームと同様に、その機(jī)能はプラグインによって強(qiáng)化されています。この記事では、Googleアナリティクスの統(tǒng)合を?qū)g用的な例として使用して、TurteCMSプラグインを作成するための基礎(chǔ)ガイドを提供します。

重要な概念：

プラグインを介した10月の拡張性により、Google Analyticsトラッキングの追加などのシームレスな統(tǒng)合が可能になります。
• コマンドラインインターフェイスは、プラグインの作成と管理を簡(jiǎn)素化し、CMS內(nèi)のグラフィカルインターフェイスを補(bǔ)完します（System＆GT; Updates）。
コンポーネントは、ユーザーインタラクションに不可欠です。コマンドラインを介して作成されるか、手動(dòng)で作成されているため、専用の「コンポーネント」フォルダーが必要です。 ユーザー入力の設(shè)定フォームの作成（Google Analytics Tracking IDなど）、コンポーネント內(nèi)で使用するこれらの設(shè)定を取得するなど、
• 広範(fàn)なカスタマイズが可能です。
• プロジェクトの概要：

コンポーネントタグを使用してGoogleアナリティクストラッキングを統(tǒng)合するプラグインを構(gòu)築します。 プラグインの設(shè)定で追跡IDを構(gòu)成した後、トラッキングを有効にするためにコンポーネントタグ（

）をページまたはパルティアルに挿入します。 完全なコードはgithubで利用できます。

プラグインマネジメント：

{% component 'gaCode' %}

10月のプラグインは、ルートディレクトリの

フォルダーにあります。 管理は介して処理されます：

system＆gt;更新：pluginsこのページでは、プロジェクトを添付し（10月のアカウントが必要）、マーケットプラグインの追加、ウェブサイトの更新が可能です。

コマンドライン：コマンドラインを使用してプラグインをインストールします（ただし、Webサイトでプラグイン名を見(jiàn)つける必要があります）。 コマンド形式（執(zhí)筆時(shí)點(diǎn)で）には通常、
• 。が含まれます。
• プラグインの作成： Author.PluginNameプラグインの作成が合理化されています：
• マニュアル方法：ディレクトリ內(nèi)に新しいフォルダーを作成します。フォルダー名は一意の名前空間として機(jī)能します（競(jìng)合を避けるために、10月のWebサイトに名前空間を登録）。 この例では、pluginsを使用します。 內(nèi)部では、RAFIE.GoogleAnalyticsCodeファイルを作成します。Plugin.php
• 足場(chǎng)（コマンドライン）：コマンドを使用を使用します。これにより、バージョンコントロール用のphp artisan create:plugin RAFIE.GoogleAnalyticsCodeファイルを含むuploadsフォルダーを含む、必要なファイルとフォルダーが自動(dòng)的に生成されます。 version.yaml
ファイルの

メソッド（オーバーライドPlugin.php）はプラグインを定義します：pluginDetails() SystemClassesPluginBase

プラグインが表示されない場(chǎng)合は、「更新の確認(rèn)」をクリックしてリストを更新します。 コンポーネントの使用

public function pluginDetails() {
    return [
        'name'        => 'Google Analytics Code',
        'description' => 'Insert Google Analytics tracking code into your pages',
        'author'      => 'RAFIE Younes',
        'icon'        => 'icon-bar-chart-o'
    ];
}

>

コンポーネントでページとのやり取りを有効にします。 手動(dòng)で（フォルダー內(nèi)）またはコマンドラインを介して作成します：

components

php artisan create:component RAFIE.GoogleAnalyticsCode GoogleAnalytics

メソッド（オーバーライド

）は、管理ダッシュボードのコンポーネントの詳細(xì)を定義します。

'scomponentDetails()メソッドでコンポーネントを登録します：CmsClassesComponentBase Plugin.php registerComponents()コンポーネントは最初に

：

public function registerComponents() {
    return [
        'RAFIE\GoogleAnalyticsCode\Components\GoogleAnalytics' => 'gaCode'
    ];
}

をレンダリングします

これをGoogle Analyticsトラッキングコードに置き換えます：default.htm

<p>></p>This is the default markup for component GoogleAnalytics>
<small>></small>You can delete this file if you want>

テーマに応じて、スクリプトをページの最後に理想的に配置する必要があることを忘れないでください。
コンポーネントのプロパティと設(shè)定：

(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
        m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');

ga('create', '{{ code }}', 'auto');
ga('send', 'pageview');

トラッキングIDをハードコードする代わりに、コンポーネントプロパティを使用します：
：

を使用してプロパティを定義します

{% component 'gaCode' code='UA-12345678-1' %}

を使用して、値をページに渡す：defineProperties()

public function defineProperties() {
    return [
        'code' => [
            'title'             => 'Google Analytics tracking code',
            'description'       => 'Your Google Analytics tracking code',
            'default'           => '',
            'type'              => 'string',
            'validationPattern' => '^UA-\d{4,9}-\d{1,4}$',
            'validationMessage' => 'Invalid tracking code',
            'placeholder'       => 'UA-XXXXXXX'
        ]
    ];
}

よりユーザーフレンドリーなアプローチについては、プラグインの設(shè)定を使用してください：

onRender()

public function onRender() {
    $this->page['code'] = $this->property('code');
}

create

：



create

：models/GoogleAnalyticsSettings.php

class GoogleAnalyticsSettings extends Model {
    public $implement = ['System.Behaviors.SettingsModel'];
    public $settingsCode = 'rafie_google_analytics_code';
    public $settingsFields = 'fields.yaml';
}

：models/fields.yamlの登録設(shè)定

fields:
  code:
    label: Your Google Analytics ID
    placeholder: UA-XXXXXXXX-X

Plugin.php

public function registerSettings() {
    return [
        'settings' => [
            'label'       => 'Google Analytics Code',
            'description' => 'Manage Google Analytics Settings',
            'icon'        => 'icon-bar-chart-o',
            'class'       => 'RAFIE\GoogleAnalyticsCode\Models\GoogleAnalyticsSettings',
            'order'       => 1
        ]
    ];
}

：

で設(shè)定を取得します

結(jié)論：onRender()

public function onRender() {
    $settings = GoogleAnalyticsSettings::instance();
    $this->page['code'] = $settings->code;
}

OctureCMSは、堅(jiān)牢で柔軟なプラグイン開(kāi)発システムを提供します。 この例は、核となる原則を示しています。ソースコードとコミュニティリソースのさらなる調(diào)査により、理解が向上します。

よくある質(zhì)問(wèn)（FAQS）：（提供されたFAQはすでに十分に構(gòu)成されており、包括的です。変更は必要ありません。

以上がBuilding OctuneCMSプラグイン：Google Analyticsの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。