میهن‌پنل — راهنمای کامل کاربر

۱. معرفی میهن‌پنل

میهن‌پنل یک افزونه وردپرس برای ساخت پنل کاربری حرفه‌ای، صفحه ورود و ثبت‌نام سفارشی، و مدیریت کاربران است. این افزونه به شما امکان می‌دهد یک تجربه کاربری یکپارچه و زیبا برای کاربران سایت خود ایجاد کنید.

امکانات کلی

• پنل کاربری — داشبورد اختصاصی برای هر کاربر با منوهای قابل تنظیم
• صفحه ورود و ثبت‌نام سفارشی — طراحی حرفه‌ای فرم‌های ورود و ثبت‌نام
• فیلدهای کاربری — افزودن فیلدهای دلخواه به پروفایل و فرم ثبت‌نام
• منوهای پنل — ساخت تب‌ها و منوهای دلخواه در پنل کاربری
• انتقال به پنل پس از ورود — هدایت کاربران عادی به پنل به‌جای پیشخوان وردپرس
• ادغام با ووکامرس — نمایش سفارشات و محصولات قابل دانلود در پنل
• پشتیبانی از WPML — سازگاری با چندزبانگی

۲. نصب و راه‌اندازی

پیش‌نیازها

• وردپرس نسخه ۵.۶ یا بالاتر
• PHP نسخه ۷.۴ یا بالاتر

نصب افزونه

1. فایل zip افزونه را از پنل کاربری یا سایت رسمی دانلود کنید.
2. در پیشخوان وردپرس به افزونه‌ها ← افزودن بروید و روی بارگذاری افزونه کلیک کنید.
3. فایل zip را انتخاب و نصب کن را بزنید.
4. بعد از نصب، افزونه را فعال‌سازی کنید.

ایجاد صفحه پنل

بعد از فعال‌سازی، باید یک برگه برای پنل کاربری ایجاد کنید. به میهن‌پنل ← ابزارها بروید و روی دکمه ایجاد صفحه پنل کاربری کلیک کنید. این کار یک برگه با شورتکد [mihanpanel] و اسلاگ panel ایجاد می‌کند. آدرس پنل کاربری شما چیزی شبیه yoursite.com/panel خواهد بود.

تنظیم اسلاگ‌ها

می‌توانید اسلاگ ورود و پنل را از میهن‌پنل ← ورود و ثبت‌نام تغییر دهید. دقت کنید اسلاگ ورود و پنل نباید یکسان باشند.

۳. ویزارد میهن‌پنل

ویزارد نصب به شما کمک می‌کند در چند مرحله ساده تنظیمات اولیه را انجام دهید. از منوی پیشخوان، میهن‌پنل ← MihanPanel Wizard را انتخاب کنید.

مراحل ویزارد

• تنظیمات ورود — تعیین آدرس صفحه ورود (مثلاً login)
• تنظیمات پنل — تعیین تنظیمات پنل کاربری
• تنظیمات امنیتی — احراز هویت دو مرحله‌ای، محافظ ورود (Login Guard)، و هدایت wp-login به صفحه ورود میهن‌پنل

در هر مرحله گزینه‌های مورد نظر را انتخاب و ذخیره کنید. می‌توانید با دکمه «بازگشت به مرحله قبل» به مراحل قبلی برگردید.

۴. ورود و ثبت‌نام

تنظیمات ورود و ثبت‌نام در میهن‌پنل ← ورود و ثبت‌نام قرار دارد.

تنظیمات اصلی

• آدرس صفحه ورود — اسلاگ برگه ورود (پیش‌فرض: login)
• لوگو و تصویر پس‌زمینه — لوگوی صفحه ورود، عرض لوگو، و تصویر پس‌زمینه
• رنگ دکمه ورود — رنگ پس‌زمینه دکمه ورود

فعال‌سازی حساب کاربری

سه حالت برای تأیید حساب کاربران جدید وجود دارد:

• فعال‌سازی خودکار — کاربر بلافاصله پس از ثبت‌نام می‌تواند وارد شود.
• ارسال لینک فعال‌سازی — یک لینک فعال‌سازی برای ایمیل کاربر ارسال می‌شود.
• فعال‌سازی دستی — مدیر سایت باید حساب کاربر را تأیید کند.

هدایت پس از ورود

کاربران عادی (غیرمدیر) پس از ورود به‌طور خودکار به پنل کاربری هدایت می‌شوند. ادمین‌ها به پیشخوان وردپرس منتقل می‌شوند. می‌توانید آدرس هدایت سفارشی پس از ورود و خروج تعیین کنید.

فرم ثبت‌نام

از بخش فرم ثبت‌نام می‌توانید متن هدر فرم ثبت‌نام را ویرایش کنید و نقش‌هایی را که کاربر می‌تواند هنگام ثبت‌نام انتخاب کند تعیین کنید.

پنهان کردن نوار ادمین

می‌توانید نوار ادمین وردپرس را برای کاربران عادی پنهان کنید. این گزینه در بخش پنل کاربری قرار دارد.

۵. پنل کاربری

تنظیمات پنل در میهن‌پنل ← پنل کاربری است.

اسلاگ پنل

اسلاگ برگه پنل را تعیین کنید (پیش‌فرض: panel). برگه باید شامل شورتکد [mihanpanel] باشد.

داشبورد

صفحه داشبورد شامل ویجت‌هایی مثل روز عضویت، تعداد نظرات، تعداد سفارشات ووکامرس، و کد تخفیف است. می‌توانید این ویجت‌ها را از تنظیمات پنل کاربری فعال یا غیرفعال کنید.

اعلان‌های داشبورد

هشت باکس اعلان (متن دلخواه) برای نمایش در داشبورد تعریف شده است. می‌توانید از بخش اعلان‌ها این متن‌ها را پر کنید.

ویرایش پروفایل

کاربران می‌توانند از تب «ویرایش پروفایل» اطلاعات خود را ویرایش کنند. فیلدهای قابل ویرایش از بخش «فیلدهای کاربری» تنظیم می‌شوند.

۶. فیلدهای کاربری

از میهن‌پنل ← فیلدهای کاربری می‌توانید فیلدهای دلخواه به فرم ثبت‌نام و صفحه ویرایش پروفایل اضافه کنید.

ساخت فیلد جدید

1. روی «افزودن فیلد جدید» کلیک کنید.
2. نام انگلیسی (اسلاگ)، برچسب، نوع فیلد (مثل متن، ایمیل، شماره، انتخاب، و غیره)، و اجباری بودن را تنظیم کنید.
3. با کشیدن و رها کردن ترتیب فیلدها را تغییر دهید و «ذخیره» را بزنید.

ترتیب و اولویت

فیلدها به‌صورت درگ‌اند‌دراپ قابل مرتب‌سازی هستند. تغییرات را با دکمه «بله» در اعلان «آیا می‌خواهید تغییرات ذخیره شود؟» ذخیره کنید.

۷. منوهای پنل

منوهای پنل در میهن‌پنل ← منوهای پنل مدیریت می‌شوند.

ساخت تب/منو

• منوی داخلی — تب با محتوای شورتکد یا HTML. محتوا در همان صفحه پنل نمایش داده می‌شود.
• لینک خارجی — تب به صورت لینک به آدرس خارجی (در تب جدید باز می‌شود).

تب‌های پیش‌فرض

در نصب اولیه، تب‌هایی مثل «محصولات قابل دانلود ووکامرس»، «سفارشات من»، و «پشتیبانی تلگرام» ایجاد می‌شوند. می‌توانید آن‌ها را ویرایش، حذف یا تب جدید اضافه کنید.

۸. اعلان‌ها

از میهن‌پنل ← اعلان‌ها می‌توانید اعلان‌های متنی برای نمایش در داشبورد کاربران ایجاد و مدیریت کنید. همچنین اعلان‌های هشت‌گانه داشبورد از بخش تنظیمات پنل کاربری قابل ویرایش است.

۹. امنیت

تنظیمات امنیتی در میهن‌پنل ← امنیت قرار دارد.

احراز هویت دو مرحله‌ای (۲FA)

احراز هویت دو مرحله‌ای را فعال کنید تا کاربران علاوه بر رمز عبور، کد OTP نیز وارد کنند. می‌توانید نقش‌های مجاز برای ۲FA را انتخاب کنید.

محافظ ورود (Login Guard)

با فعال کردن این گزینه، پس از تعداد مشخصی تلاش ناموفق برای ورود، آی‌پی کاربر مسدود می‌شود. تعداد تلاش مجاز و مدت زمان رفع مسدودیت را تنظیم کنید.

لیست آی‌پی‌های مسدود

از میهن‌پنل ← Blocked ip می‌توانید آی‌پی‌های مسدود شده را مشاهده و در صورت نیاز حذف کنید.

گوگل ریکپچا و کپچای سفارشی

می‌توانید گوگل ریکپچا یا کپچای سفارشی را در فرم ورود، ثبت‌نام، و بازیابی رمز عبور فعال کنید.

۱۰. ایمیل‌ها

تنظیمات ایمیل در میهن‌پنل ← ایمیل‌ها قرار دارد.

ایمیل خوش‌آمدگویی

متن ایمیل اطلاع‌رسانی به کاربر جدید پس از ثبت‌نام را ویرایش کنید.

بازیابی رمز عبور

موضوع و محتوای ایمیل بازیابی رمز عبور را سفارشی کنید.

تغییر وضعیت حساب

در صورت استفاده از فعال‌سازی دستی، موضوع و محتوای ایمیل تأیید یا غیرفعال‌سازی حساب را تنظیم کنید.

ارسال از

گزینه ایمیل ارسال‌کننده را در تنظیمات میهن‌پنل پیدا کرده و ایمیل دلخواه خود را برای ارسال ایمیل‌های وردپرس مشخص کنید. حتماً این ایمیل را در بخش Email Accounts در پنل هاستینگ خود ایجاد کرده باشید تا ایمیل‌ها ارسال شوند.

رفع مشکل ارسال ایمیل

در صورتی که ایمیل‌ها ارسال نمی‌شوند، ابتدا از تنظیم صحیح ایمیل ارسال‌کننده اطمینان حاصل کنید. اگر باز هم مشکل ادامه داشت، به آموزش‌های حل مشکل ارسال ایمیل در وردپرس مراجعه کنید.

۱۱. شورتکدها

شورتکدها را می‌توانید در برگه‌ها، نوشته‌ها، یا ابزارک‌های وردپرس استفاده کنید. همچنین می‌توانید از آن‌ها در بخش مدیریت منوهای میهن‌پنل استفاده کنید.

شورتکدهای اصلی

• [mihanpanel] — نمایش پنل کاربری اصلی. این شورتکد را در برگه پنل قرار دهید.
• [mp_woocommerce_orders] — نمایش لیست سفارشات ووکامرس کاربر (نیاز به ووکامرس).
• [mihanpanel_woo_downloads] — نمایش محصولات دانلودی خریداری‌شده ووکامرس کاربر (نیاز به ووکامرس).
• [download_history] — نمایش لیست دانلودهای خریداری‌شده در Easy Digital Downloads (نیاز به EDD).
• [mw_restrict roles="administrator,subscriber" alternative_text="متنی برای کاربران غیرمجاز"] — محدود کردن محتوا به نقش‌های خاص.

ویجت پروفایل

ویجت «User Profile - Mihanpanel» را از ظاهر ← ویجت‌ها به سایدبار اضافه کنید تا منوی ورود/خروج و لینک پنل در سایدبار نمایش داده شود.

۱۲. ادغام با ووکامرس

میهن‌پنل با ووکامرس ادغام شده است:

• سفارشات کاربر در تب «سفارشات من» یا با شورتکد [mp_woocommerce_orders] نمایش داده می‌شود.
• محصولات قابل دانلود در تب «محصولات قابل دانلود» یا با شورتکد [mihanpanel_woo_downloads] نمایش داده می‌شود.
• می‌توانید کاربران غیر لاگین را از صفحه تسویه به صفحه ورود هدایت کنید.
• بخش محصولات اخیر در داشبورد قابل نمایش است.

۱۳. ابزارها

از میهن‌پنل ← ابزارها:

• ایجاد صفحه پنل کاربری — ایجاد خودکار برگه با شورتکد [mihanpanel].
• ایجاد جداول دیتابیس — در صورت بروز مشکل، جداول پنل را مجدداً ایجاد کنید.
• انتقال شماره تلفن از Digits — انتقال شماره‌های Digits به میهن‌پنل.

۱۴. امکانات پیشرفته

میهن‌پنل امکانات پیشرفتهٔ زیر را ارائه می‌دهد:

• ورود با SMS — ورود با کد یکبار مصرف ارسالی به موبایل
• ورود هوشمند (Smart Login) — ثبت‌نام و ورود با ایمیل یا موبایل بدون نیاز به رمز عبور قبلی
• ورود با گوگل — ورود با اکانت گوگل
• منوهای پنل — مدیریت تب‌ها و منوهای پنل
• اعلان‌های پیشرفته — مدیریت اعلان‌ها
• گوگل ریکپچا و کپچای سفارشی
• احراز هویت دو مرحله‌ای پیشرفته — تعیین نقش‌های مجاز
• تنظیمات ظاهری پنل — تم ۲۰۲۵، فونت، رنگ سایدبار
• بخش وبلاگ و محصولات اخیر در داشبورد
• شورتکد محدودیت محتوا — [mw_restrict]
• ویجت Elementor برای دکمه ورود

۱۵. افزودن درگاه پیامکی سفارشی

میهن‌پنل به‌صورت پیش‌فرض قابلیت ارسال پیامک با استفاده از چند شرکت ایرانی را دارد. در صورتی که ارائه‌دهندهٔ خدمات پیامک هستید، می‌توانید با استفاده از فیلتر و رابط برنامه‌نویسی زیر، درگاه پیامکی خود را به میهن‌پنل اضافه کنید.

ثبت ارائه‌دهنده

ابتدا ارائه‌دهندهٔ خدمات اس‌ام‌اس را با فیلتر mihanpanel_sms_providers ثبت کنید:

add_filter('mihanpanel_sms_providers', function($providers){
    $providers['mihan_sms'] = [
        'title' => 'Mihan SMS',
        'class' => MihanSMS::class,
        'path' => plugin_dir_path(__FILE__) . 'mihansms.php'
    ];
    return $providers;
});

واسط برنامه‌نویسی

کلاس شما باید mihanpanel\pro\app\contracts\sms_provider_interface را پیاده‌سازی کند. متدهای لازم:

• send($to, $msg) — روش ارسال پیامک
• render_settings() — فیلدهای تنظیمات برای نمایش در پنل
• get_provider_settings() — کلیدهای تنظیمات به‌صورت آرایه
• validate_send_message($response) — اعتبارسنجی موفق بودن ارسال

مثال کامل کلاس

<?php
use mihanpanel\pro\app\contracts\sms_provider_interface;

class MihanSMS implements sms_provider_interface {
    static function send($to, $msg)
    {
        // send sms process
    }

    static function render_settings()
    {
        $api_key = get_option('mihansms_api_key');
        $gateway_number = get_option('mihansms_gateway');
        ?>
        <p>
            <label for="mihansms_api_key">API Key</label>
            <input value="<?php echo $api_key; ?>" type="text" name="mihansms_api_key" id="mihansms_api_key">
        </p>
        <p>
            <label for="mihansms_gateway">Gateway Number</label>
            <input type="text" value="<?php echo $gateway_number; ?>" name="mihansms_gateway" id="mihansms_gateway">
        </p>
        <?php
    }

    static function get_provider_settings()
    {
        return [
            'mihansms_api_key',
            'mihansms_gateway',
        ];
    }

    static function validate_send_message($response)
    {
        // validate send sms
    }
}

تنظیم sanitize callback

برای اعمال sanitize callback روی تنظیمات، می‌توانید به‌جای رشته، آرایه‌ای با کلیدهای setting_name و sanitize_callback برگردانید:

static function get_provider_settings()
{
    return [
        [
            'setting_name' => 'mihansms_api_key',
            'sanitize_callback' => 'sanitize_gateway_number'
        ],
        'mihansms_gateway'
    ];
}

function sanitize_gateway_number($input = null)
{
    // do some ...
}

نام فیلدهای render_settings() باید با کلیدهای بازگردانده‌شده در get_provider_settings() یکسان باشد.

می‌توانید افزونهٔ پنل پیامکی خود را برای ما ارسال کنید تا در کنار میهن‌پنل در دسترس کاربران قرار گیرد.

۱۶. راهنما و پشتیبانی

• برای خرید و فعال‌سازی لایسنس به mihanwp.com/mihanpanel مراجعه کنید.
• همیشه قبل از به‌روزرسانی افزونه از سایت پشتیبان بگیرید.
• وردپرس، PHP و افزونه‌ها را به‌روز نگه دارید.
• اسلاگ ورود و پنل نباید یکسان باشند.
• صفحه پنل حتماً باید شورتکد [mihanpanel] را داشته باشد.

برای راهنمایی و پشتیبانی بیشتر به مستندات و کانال پشتیبانی رسمی میهن‌پنل مراجعه کنید.