Octobercms Plugin Development: Contoh Google Analytics
OktoberCMS adalah sistem pengurusan kandungan yang berkembang pesat (CMS), dan seperti semua platform CMS, fungsinya dipertingkatkan melalui plugin. Artikel ini menyediakan panduan asas untuk membuat plugin OktoberCMS, menggunakan integrasi Google Analytics sebagai contoh praktikal.
Konsep Utama:
- Extensibility OctoberCMS melalui plugin membolehkan integrasi lancar, seperti menambah penjejakan Google Analytics.
- Antara muka baris arahan memudahkan penciptaan dan pengurusan plugin, menambah antara muka grafik dalam CMS (Sistem & GT; kemas kini).
- komponen adalah penting untuk interaksi pengguna; Mereka dicipta melalui baris arahan atau secara manual, memerlukan folder komponen yang berdedikasi.
- Penyesuaian yang luas adalah mungkin, termasuk membuat borang tetapan untuk input pengguna (seperti ID Penjejakan Google Analytics), dan mengambil tetapan ini untuk digunakan dalam komponen.
Gambaran keseluruhan projek:
Kami akan membina plugin yang mengintegrasikan penjejakan Google Analytics menggunakan tag komponen. Selepas mengkonfigurasi ID penjejakan anda dalam tetapan plugin, anda akan memasukkan tag komponen () ke dalam halaman atau separa anda untuk membolehkan penjejakan. Kod Lengkap tersedia di GitHub. {% component 'gaCode' %}
Plugin Management:
Plugin OktoberCMS tinggal di folderplugins
- System & gt; Kemas kini:
- Halaman ini membolehkan projek melampirkan (memerlukan akaun OktoberCMS), menambah plugin pasaran, dan mengemas kini laman web anda. baris perintah:
- Pasang plugin menggunakan baris arahan (walaupun mencari nama plugin di laman web diperlukan). Format arahan (pada masa penulisan) biasanya melibatkan .
Author.PluginName
Membuat plugin diselaraskan:
- Kaedah Manual:
Buat folder baru dalam direktori . Nama folder bertindak sebagai ruang nama unik anda (mendaftarkan ruang nama anda di laman web OktoberCMS untuk mengelakkan konflik). Untuk contoh ini, kami akan menggunakanplugins. Di dalam, buat failRAFIE.GoogleAnalyticsCode.Plugin.php - perancah (baris perintah): Gunakan perintah . Ini secara automatik menjana fail dan folder yang diperlukan, termasuk folder
php artisan create:plugin RAFIE.GoogleAnalyticsCodeyang mengandungi failuploadsuntuk kawalan versi.version.yaml
Plugin.php fail (overriding pluginDetails()) mentakrifkan plugin: SystemClassesPluginBase
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'
];
} Jika plugin tidak muncul, klik "Semak kemas kini" untuk menyegarkan senarai.
Menggunakan komponen:
Komponen membolehkan interaksi dengan halaman. Buat mereka secara manual (dalam folder) atau melalui baris arahan: components
php artisan create:component RAFIE.GoogleAnalyticsCode GoogleAnalytics
kaedah
) mentakrifkan butiran komponen untuk papan pemuka admin. Daftar komponen dalam componentDetails() 's CmsClassesComponentBase kaedah: Plugin.php
registerComponents()
public function registerComponents() {
return [
'RAFIE\GoogleAnalyticsCode\Components\GoogleAnalytics' => 'gaCode'
];
}:
default.htm
<p>></p>This is the default markup for component GoogleAnalytics> <small>></small>You can delete this file if you want>
ingat bahawa skrip harus diletakkan pada akhir halaman, bergantung pada tema anda.
(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');
sifat komponen dan tetapan:
Daripada mengodkan id penjejakan, gunakan sifat komponen:
Tentukan sifat menggunakan
{% 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'
]
];
} untuk lulus nilai ke halaman:
onRender()
public function onRender() {
$this->page['code'] = $this->property('code');
}
Buat 
:
models/GoogleAnalyticsSettings.php Buat
class GoogleAnalyticsSettings extends Model {
public $implement = ['System.Behaviors.SettingsModel'];
public $settingsCode = 'rafie_google_analytics_code';
public $settingsFields = 'fields.yaml';
}
models/fields.yaml Daftar Tetapan dalam
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
]
];
} mengambil tetapan dalam : 
onRender() Kesimpulan:
public function onRender() {
$settings = GoogleAnalyticsSettings::instance();
$this->page['code'] = $settings->code;
}
OktoberCMS menawarkan sistem pembangunan plugin yang mantap dan fleksibel. Contoh ini menunjukkan prinsip teras; Penjelajahan lebih lanjut mengenai kod sumber dan sumber komuniti akan meningkatkan pemahaman anda. Soalan Lazim (Soalan Lazim): (Soalan Lazim yang disediakan sudah berstruktur dan komprehensif. Tiada perubahan yang diperlukan.)
Atas ialah kandungan terperinci Membina Plugin Oktobercms: Google Analytics. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!
Alat AI Hot
Undress AI Tool
Gambar buka pakaian secara percuma
Undresser.AI Undress
Apl berkuasa AI untuk mencipta foto bogel yang realistik
AI Clothes Remover
Alat AI dalam talian untuk mengeluarkan pakaian daripada foto.
Clothoff.io
Penyingkiran pakaian AI
Video Face Swap
Tukar muka dalam mana-mana video dengan mudah menggunakan alat tukar muka AI percuma kami!
Artikel Panas
Alat panas
Notepad++7.3.1
Editor kod yang mudah digunakan dan percuma
SublimeText3 versi Cina
Versi Cina, sangat mudah digunakan
Hantar Studio 13.0.1
Persekitaran pembangunan bersepadu PHP yang berkuasa
Dreamweaver CS6
Alat pembangunan web visual
SublimeText3 versi Mac
Perisian penyuntingan kod peringkat Tuhan (SublimeText3)
Skop pembolehubah PHP dijelaskan
Jul 17, 2025 am 04:16 AM
Masalah dan penyelesaian biasa untuk skop pembolehubah PHP termasuk: 1. Pembolehubah global tidak dapat diakses dalam fungsi, dan ia perlu diluluskan menggunakan kata kunci atau parameter global; 2. Pembolehubah statik diisytiharkan dengan statik, dan ia hanya dimulakan sekali dan nilai dikekalkan antara pelbagai panggilan; 3. Pembolehubah hyperglobal seperti $ _get dan $ _post boleh digunakan secara langsung dalam mana -mana skop, tetapi anda perlu memberi perhatian kepada penapisan yang selamat; 4. Fungsi Anonymous perlu memperkenalkan pembolehubah skop induk melalui kata kunci penggunaan, dan apabila mengubah suai pembolehubah luaran, anda perlu lulus rujukan. Menguasai peraturan ini boleh membantu mengelakkan kesilapan dan meningkatkan kestabilan kod.
Bagaimana cara mengendalikan fail memuat naik dengan selamat di PHP?
Jul 08, 2025 am 02:37 AM
Untuk mengendalikan muat naik fail PHP dengan selamat, anda perlu mengesahkan sumber dan jenis, mengawal nama fail dan laluan, menetapkan sekatan pelayan, dan memproses fail media dua kali. 1. Sahkan sumber muat naik untuk mengelakkan CSRF melalui token dan mengesan jenis mime sebenar melalui finfo_file menggunakan kawalan putih; 2. Namakan semula fail ke rentetan rawak dan tentukan pelanjutan untuk menyimpannya dalam direktori bukan web mengikut jenis pengesanan; 3. Konfigurasi PHP mengehadkan saiz muat naik dan direktori sementara Nginx/Apache melarang akses ke direktori muat naik; 4. Perpustakaan GD menyambung semula gambar -gambar untuk membersihkan data yang berpotensi.
Mengulas kod dalam php
Jul 18, 2025 am 04:57 AM
Terdapat tiga kaedah umum untuk kod komen PHP: 1. Use // atau # untuk menyekat satu baris kod, dan disyorkan untuk menggunakan //; 2. Gunakan /.../ untuk membungkus blok kod dengan pelbagai baris, yang tidak boleh bersarang tetapi boleh diseberang; 3. Komen -komen kemahiran gabungan seperti menggunakan / jika () {} / untuk mengawal blok logik, atau untuk meningkatkan kecekapan dengan kunci pintasan editor, anda harus memberi perhatian kepada simbol penutupan dan mengelakkan bersarang apabila menggunakannya.
Bagaimana penjana berfungsi dalam php?
Jul 11, 2025 am 03:12 AM
Ageneratorinphpisamemory-efficientwaytoiterateOverlargedatasetsbyieldingvaluesonateatimeNsteadofreturningthemallatonce.1.GeneratorSuseTheyEldeyWorderWorderToProducevaluuesondemand,
Petua untuk menulis komen php
Jul 18, 2025 am 04:51 AM
Kunci untuk menulis komen PHP adalah untuk menjelaskan tujuan dan spesifikasi. Komen harus menjelaskan "mengapa" dan bukannya "apa yang dilakukan", mengelakkan redundansi atau terlalu kesederhanaan. 1. Gunakan format bersatu, seperti docblock (/*/) untuk deskripsi kelas dan kaedah untuk meningkatkan keserasian dan keserasian alat; 2. Menekankan sebab -sebab di sebalik logik, seperti mengapa JS melompat perlu dikeluarkan secara manual; 3. Tambahkan gambaran keseluruhan gambaran sebelum kod kompleks, terangkan proses dalam langkah -langkah, dan membantu memahami idea keseluruhan; 4. Gunakan Todo dan Fixme secara rasional untuk menandakan item dan masalah untuk memudahkan penjejakan dan kerjasama berikutnya. Anotasi yang baik dapat mengurangkan kos komunikasi dan meningkatkan kecekapan penyelenggaraan kod.
Cara mengakses watak dalam rentetan dengan indeks dalam php
Jul 12, 2025 am 03:15 AM
Dalam PHP, anda boleh menggunakan kurungan persegi atau pendakap keriting untuk mendapatkan aksara indeks spesifik rentetan, tetapi kurungan persegi disyorkan; Indeks bermula dari 0, dan akses di luar julat mengembalikan nilai null dan tidak dapat diberikan nilai; MB_SUBSTR dikehendaki mengendalikan watak multi-bait. Sebagai contoh: $ str = "hello"; echo $ str [0]; output h; dan watak -watak Cina seperti MB_SUBSTR ($ str, 1,1) perlu mendapatkan hasil yang betul; Dalam aplikasi sebenar, panjang rentetan perlu diperiksa sebelum gelung, rentetan dinamik perlu disahkan untuk kesahihan, dan projek berbilang bahasa mengesyorkan menggunakan fungsi keselamatan multi-bait secara seragam.
Tutorial pemasangan php cepat
Jul 18, 2025 am 04:52 AM
Toinstallphpquickly, usexampponwindowsorhomeBrewonmacos.1.onwindows, downloadandInstallxampp, selectcomponents, startapache, andplaceFilesinhtdocs.2.alternative, secara manualstallphpfromphp.netandsheBerver.3
Belajar PHP: Panduan Pemula
Jul 18, 2025 am 04:54 AM
Tolearnphpeffectively, startbysettingupalocalverenvironmentusingToolsLikexamppandaCodeDitorLikevscode.1) InstallXamppforapa Che, MySql, danPhp.2) UseAcodeeditorForsyntaxSupport.3) testyoursetupwithasimplephpfile.next, learnphpbasicsincludingvariables, ech
