🧩
Veb-sayt

WordPress uçun maxsus plagin yaratiş: header, hook va shortcode bilan amaliy qöllanma

04.12.2025
← Barça maqolalar

WordPress millionlab saytlarning asosini taşkil etadi va uning eng kuçli tomoni — kengaytiriluvçanligi. Saytingizga yangi imkoniyat qöşmoqçi bölganingizda odatda tayyor plagin qidirasiz, lekin har doim ham aniq kerakli funksiyani bajaradigan tayyor yeçim topilavermaydi. Ba'zida mavjud plaginlar haddan ortiq oğir, keraksiz funksiyalar bilan töla yoki sizning maxsus biznes mantiğingizga töğri kelmaydi. Aynan şu paytda öz plaginingizni yoziş eng töğri yöl böladi — çunki u faqat sizga kerak bölgan işni bajaradi, yengil böladi va töliq nazoratingizda qoladi.

Öz plaginingizni yozişning yana bir muhim sababi — kodni mavzudan (theme) ajratib qöyişdir. Agar funksionallikni mavzu fayllariga yozsangiz, mavzuni özgartirganingizda hamma narsa yöqoladi. Plaginda yozilgan kod esa mavzudan mustaqil işlaydi va sayt dizaynini almaştirsangiz ham saqlanib qoladi. Bu professional yondaşuv hisoblanadi va WordPress hamjamiyati tomonidan tavsiya etiladi. Quyida plaginning tuzilmasidan boşlab uni sinaş va tarqatişgaça bölgan butun jarayonni amaliy kod misollari bilan körib çiqamiz.

Plagin tuzilmasi va asosiy fayl headeri

WordPress plagini wp-content/plugins/ papkasida joylaşadi. Eng oddiy plagin bitta PHP fayldan iborat bölişi mumkin, lekin yaxşi amaliyot — har bir plagin uçun alohida papka yaratişdir. Masalan, wp-content/plugins/sayt-uz-tools/ papkasini yaratib, içiga sayt-uz-tools.php asosiy faylini joylaştirasiz. WordPress plaginni tanib olişi uçun bu faylning boşida maxsus izoh blokini — plagin headerini yoziş şart. Aynan şu header WordPress admin panelidagi plaginlar röyxatida körinadigan ma'lumotlarni belgilaydi.

<?php
/**
 * Plugin Name: Sayt UZ Tools
 * Plugin URI:  https://sayt.uz/plugins/sayt-uz-tools
 * Description: Sayt uchun maxsus qisqa kodlar va admin sozlamalari.
 * Version:     1.0.0
 * Author:      Sayt UZ
 * Author URI:  https://sayt.uz
 * License:     GPL-2.0+
 * Text Domain: sayt-uz-tools
 */

// To'g'ridan-to'g'ri kirishni taqiqlash
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

Headerda kamida Plugin Name bölişi şart — qolgan maydonlar ixtiyoriy, lekin ularni töldiriş professional köriniş beradi. Eng oxiridagi ABSPATH tekşiruvi juda muhim: u faylga töğridan-töğri brauzer orqali kirişni tösib qöyadi va kodni faqat WordPress yadrosi orqali işga tuşirilişini ta'minlaydi. Bu xavfsizlikning birinçi qadami bölib, har bir plagin faylida bölişi kerak.

Hook tizimi: action va filter

WordPress kengaytiriluvçanligining yuragi — hook tizimidir. Hooklar ikki turga bölinadi: action va filter. Action — bu WordPress iş jarayonining ma'lum bir nuqtasida sizning kodingizni işga tuşiriş imkonini beradi, masalan, sahifa yuklanganda yoki post saqlanganda biror amal bajariş. Filter esa — ma'lumotni ekranga çiqişidan oldin özgartiriş imkonini beradi, masalan, post matnini körsatişdan avval unga qöşimça kontent qöşiş. Tuşuniş uçun oddiy qoida: action biror işni bajaradi, filter esa ma'lumotni özgartiradi va albatta qiymat qaytaradi.

// Action misoli: footer'ga matn qo'shish
function sayt_uz_footer_text() {
    echo '<p style="text-align:center">Sayt.uz tomonidan ishlab chiqildi</p>';
}
add_action( 'wp_footer', 'sayt_uz_footer_text' );

// Filter misoli: post oxiriga eslatma qo'shish
function sayt_uz_append_notice( $content ) {
    if ( is_single() ) {
        $content .= '<p class="notice">Maqola yoqdimi? Ulashing!</p>';
    }
    return $content;
}
add_filter( 'the_content', 'sayt_uz_append_notice' );

Bu misolda add_action WordPress'ga "footer çizilayotganda mening funksiyamni çaqir" deb aytadi, add_filter esa "post matnini körsatişdan oldin uni mening funksiyamdan ötkaz" deb buyuradi. Filter funksiyasi har doim özgartirilgan qiymatni qaytarişi şart — agar return qilmasangiz, post matni böş çiqib qoladi. Bu eng köp uçraydigan xatolardan biri, şuning uçun filterlar bilan işlaganda doim qaytariladigan qiymatni eslab turing.

Amaliy plagin: shortcode va admin sahifa

Endi haqiqiy foydali narsa yaratamiz. Shortcode — bu post yoki sahifaga [sayt_button] kabi oddiy yozuv qöyib, örniga töliq HTML çiqaradigan mexanizm. Bu kontent muharrirlariga kod yozmasdan murakkab elementlarni qöşiş imkonini beradi. Quyidagi misolda biz sozlanadigan tugma çiqaradigan shortcode yaratamiz, unda matn va havola parametr sifatida uzatiladi.

function sayt_uz_button_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'text' => 'Bog\'lanish',
        'url'  => '#',
    ), $atts, 'sayt_button' );

    $text = esc_html( $atts['text'] );
    $url  = esc_url( $atts['url'] );

    return '<a class="sayt-btn" href="' . $url . '">' . $text . '</a>';
}
add_shortcode( 'sayt_button', 'sayt_uz_button_shortcode' );

Endi muharrir har qanday postga [sayt_button text="Buyurtma" url="/order"] deb yozsa, çiroyli tugma paydo böladi. E'tibor bering, biz esc_html va esc_url funksiyalaridan foydalandik — bu çiqayotgan ma'lumotni tozalaydi va XSS hujumlaridan himoya qiladi. Foydalanuvçidan kelgan har qanday ma'lumotni ekranga çiqarişdan oldin şunday tozalaş WordPress xavfsizligining oltin qoidasidir.

Plaginlarga köpinça sozlama sahifasi kerak böladi. Admin menyusiga yangi bölim qöşiş uçun admin_menu hookidan foydalanamiz va sozlamalarni saqlaş uçun nonce hamda sanitization qöllaymiz.

function sayt_uz_admin_menu() {
    add_options_page(
        'Sayt UZ Tools',
        'Sayt UZ Tools',
        'manage_options',
        'sayt-uz-tools',
        'sayt_uz_settings_page'
    );
}
add_action( 'admin_menu', 'sayt_uz_admin_menu' );

function sayt_uz_settings_page() {
    if ( isset( $_POST['sayt_uz_save'] ) &&
         check_admin_referer( 'sayt_uz_settings', 'sayt_uz_nonce' ) ) {
        $val = sanitize_text_field( $_POST['sayt_uz_title'] );
        update_option( 'sayt_uz_title', $val );
        echo '<div class="updated"><p>Saqlandi</p></div>';
    }
    $title = esc_attr( get_option( 'sayt_uz_title', '' ) );
    echo '<div class="wrap"><h1>Sozlamalar</h1>';
    echo '<form method="post">';
    wp_nonce_field( 'sayt_uz_settings', 'sayt_uz_nonce' );
    echo '<input type="text" name="sayt_uz_title" value="' . $title . '">';
    echo '<input type="submit" name="sayt_uz_save" value="Saqlash" class="button-primary">';
    echo '</form></div>';
}

Eng yaxşi amaliyotlar: prefiks va xavfsizlik

Plagin yozişda eng muhim qoidalardan biri — barça funksiya, özgaruvçi va sozlama nomlariga noyob prefiks qöyişdir. Yuqoridagi misollarda biz sayt_uz_ prefiksidan foydalandik. Buning sababi şundaki, WordPress saytida önlab plaginlar bir vaqtda işlaydi va agar ikki plaginda bir xil nomli funksiya bölsa, sayt butunlay işdan çiqadi. Prefiks bu nizolarning oldini oladi va kodingizni boşqa plaginlardan ajratib turadi.

Xavfsizlik böyiça uçta tamoyilni doim eslab turing. Birinçidan, foydalanuvçidan kelgan har qanday ma'lumotni saqlaşdan oldin sanitize_text_field kabi funksiyalar bilan tozalang. Ikkinçidan, ekranga çiqarişdan oldin esc_html, esc_url yoki esc_attr bilan ekranlaş qiling. Uçinçidan, har qanday formada nonce işlating — wp_nonce_field bilan yarating va check_admin_referer bilan tekşiring. Nonce — bu sörovning haqiqatan ham sizning saytingizdan kelganini tasdiqlovçi maxsus token bölib, CSRF hujumlaridan himoya qiladi.

Faollaştiriş, sinaş va tarqatiş

Plaginni faollaştiriş va öçirişda maxsus amallar bajariş kerak bölişi mumkin, masalan ma'lumotlar bazasida jadval yaratiş yoki standart sozlamalarni örnatiş. Buning uçun register_activation_hook va register_deactivation_hook funksiyalaridan foydalaniladi. Plaginni yozib bölgaç, uni WordPress admin panelining "Plaginlar" bölimidan faollaştiring va xato xabarlari çiqmaganini tekşiring. Sinaş davomida WP_DEBUG rejimini yoqib qöying, şunda barça PHP ogohlantirişlari körinadi va kodni mukammallaştirişga yordam beradi.

Plaginingiz tayyor va işonçli bölgaç, uni tarqatişingiz mumkin. Eng oddiy yöl — papkani ZIP arxivga joylaş va WordPress admin panelining "Plagin yuklaş" funksiyasi orqali örnatiş. Agar plaginni keng jamoatçilikka taqdim etmoqçi bölsangiz, uni WordPress.org rasmiy katalogiga yuborişingiz mumkin — bu yerda kod GPL litsenziyasi va xavfsizlik talablariga javob berişi tekşiriladi. Öz plaginingizni yoziş könikmasi sizni oddiy WordPress foydalanuvçisidan haqiqiy dasturçiga aylantiradi va saytingizga çeksiz imkoniyatlar eşigini oçadi.

Öxşaş maqolalar

🧾 Onlayn dökon va fiskal çek: virtual kassa talablari 💻 IT kompaniya sayti: software house, autsorsing va developer servisi uçun strategiya 🌾 Qişloq xöjaligi va agrobiznes sayti: mahsulotlar katalogi va B2B sotuv 🧪 Tibbiy laboratoriya sayti: testlar katalogi, onlayn buyurtma va natija oliş
🌐 Til
🇺🇿 O⁠'zbek 🇺🇿 Özbek (yangi) ✓ 🇺🇿 Ўзбек 🇷🇺 Русский 🇬🇧 English