نمایش تعداد فالوور X در وردپرس؛ آموزش کامل

اگه می‌خواید تعداد دنبال‌کننده‌های حساب X رو داخل سایت وردپرسی نشون بدید، باید این عدد رو از X API بگیرید. API یعنی راهی که دو نرم‌افزار از طریق اون با هم اطلاعات ردوبدل می‌کنن. وردپرس درخواست رو برای X می‌فرسته، تعداد فالوورها رو از پاسخ برمی‌داره و بعد اون رو داخل نوشته، برگه، هدر یا فوتر نشون می‌ده.

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

قبل از شروع چه چیزهایی نیاز دارید؟

قبل از تغییر سایت، بهتره چند مورد رو آماده کنید. مهم‌ترین مورد، یک حساب X و دسترسی به پنل توسعه‌دهنده X هست. ساخت حساب معمولی X به‌تنهایی کافی نیست و باید شرایط فعلی حساب توسعه‌دهنده رو هم داخل همین پنل بررسی کنید.

• حساب X و دسترسی توسعه‌دهنده: برای ساخت اپ و دریافت توکن به این دسترسی نیاز دارید.
• سطح دسترسی مناسب: طرح انتخابی شما باید اجازه خواندن اطلاعات عمومی کاربر رو بده.
• بررسی هزینه: مدل دسترسی و هزینه X API ممکنه تغییر کنه. قبل از شروع، قیمت و سهمیه دقیق رو داخل پنل توسعه‌دهنده خودتون ببینید.
• نسخه پشتیبان: قبل از اضافه‌کردن کد، از فایل‌ها و پایگاه داده سایتتون نسخه پشتیبان بگیرید.
• دسترسی به فایل‌های وردپرس: برای ساخت افزونه کوچک به فایل منیجر هاست یا FTP نیاز دارید.

بهتره کد این آموزش رو داخل قالب اصلی نذارید. چون با به‌روزرسانی قالب ممکنه تغییراتتون پاک بشن. یک افزونه اختصاصی کوچک یا قالب فرزند جای مطمئن‌تریه. در این آموزش از افزونه کوچک استفاده می‌کنیم تا کد به قالب سایت وابسته نباشه.

چالش‌های نمایش اطلاعات X برای کاربران ایرانی

در حال حاضر دسترسی مستقیم به X در ایران با محدودیت روبه‌روئه و کاربران معمولاً برای بازکردن سایت، پنل توسعه‌دهنده یا صفحه پروفایل به ابزار تغییر مسیر اینترنت نیاز دارن. وضعیت دسترسی ممکنه تغییر کنه؛ پس بهتره قبل از اجرای آموزش، بازشدن بخش‌های موردنیاز رو با اینترنت و سرویس خودتون بررسی کنید.

تغییر مداوم نشانی IP می‌تونه ورود به حساب و پنل توسعه‌دهنده رو سخت‌تر کنه. ممکنه X ورود تازه رو مشکوک تشخیص بده، تأیید امنیتی بخواد یا نشست حساب رو ببنده. برای کم‌کردن این دردسر، بهتره از اتصال مطمئن و نسبتاً ثابت استفاده کنید، تأیید دومرحله‌ای رو فعال نگه دارید و کدهای بازیابی حسابتون رو در جای امنی ذخیره کنید.

یادتون باشه اتصال مرورگر شما با اتصال سرور وردپرس یکی نیست. حتی اگه خودتون با ابزار تغییر مسیر اینترنت وارد X بشید، درخواست API کد این مقاله از طرف هاست ارسال می‌شه. پس نصب یا فعال‌بودن چنین ابزاری روی گوشی یا کامپیوتر شما مشکل اتصال هاست رو حل نمی‌کنه. اگه سایت روی هاست داخل ایران قرار داره، باید از پشتیبانی هاست بپرسید که سرور می‌تونه به دامنه api.x.com وصل بشه یا نه.

• دسترسی ناپایدار به پنل: ساخت اپ، گرفتن توکن و بررسی میزان مصرف ممکنه با قطع اتصال یا تغییر IP نیمه‌کاره بمونه.
• خطای اتصال سرور: هاست ممکنه نتونه درخواست رو به X API بفرسته؛ حتی وقتی X در مرورگر شما باز می‌شه.
• نمایش‌ندادن لینک یا محتوای جاسازی‌شده: بازدیدکننده‌ای که دسترسی مستقیم به X نداره، ممکنه نتونه پروفایل، پست یا تایم‌لاین جاسازی‌شده رو باز کنه.
• تجربه کاربری ضعیف‌تر: فرستادن کاربر به صفحه‌ای که بدون اتصال مناسب باز نمی‌شه، می‌تونه باعث سردرگمی یا ترک صفحه بشه.
• ریسک امنیتی ابزارهای ناشناس: سرویس‌های نامطمئن ممکنه حریم خصوصی یا اطلاعات ورودتون رو به خطر بندازن. رمز، توکن و کد بازیابی رو داخل ابزار یا سایت ناشناس وارد نکنید.

قبل از انتشار، شورت‌کد رو هم روی هاست و هم با اینترنتی شبیه اینترنت بازدیدکننده‌های ایرانی آزمایش کنید. اگه اتصال API پایدار نیست، بهتره آخرین مقدار موفق رو نگه دارید یا به‌جای شمارنده زنده، یک لینک ساده همراه با توضیح کوتاه بذارید. قوانین محل زندگی، شرایط استفاده X و مقررات شرکت میزبان رو هم بررسی کنید.

نمایش تعداد فالوور X در وردپرس چطور کار می‌کنه؟

فرایند کار سه بخش داره. وردپرس با کمک توکن دسترسی، اطلاعات عمومی نام کاربری موردنظر رو از X API می‌گیره. پاسخ API شامل بخشی به نام public_metrics هست که آمار عمومی حساب، از جمله followers_count، داخل اون قرار می‌گیره. کد ما فقط عدد فالوورها رو از این پاسخ جدا می‌کنه.

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

• وردپرس نام کاربری رو به X API می‌فرسته.
• X اطلاعات عمومی حساب و تعداد فالوورها رو برمی‌گردونه.
• وردپرس عدد رو برای یک ساعت ذخیره می‌کنه.
• بازدیدکننده‌های بعدی عدد ذخیره‌شده رو می‌بینن و درخواست تازه‌ای ارسال نمی‌شه.

ساخت پروژه و اپ در پنل توسعه‌دهنده X

ورود به پنل و ساخت پروژه

وارد پنل توسعه‌دهنده X بشید(یادتون باشه حتما با فیلترشکن وارد بشید) و بخش مدیریت پروژه‌ها و اپ‌ها رو باز کنید. اگه هنوز پروژه‌ای ندارید، یک پروژه تازه بسازید. نامی انتخاب کنید که بعداً کاربرد اون رو راحت تشخیص بدید؛ برای نمونه می‌تونید نام سایتتون رو وارد کنید.

نام و جای دقیق گزینه‌های پنل ممکنه با تغییر رابط X عوض بشه. به همین خاطر، به‌جای تکیه به نام یک دکمه قدیمی، دنبال بخش Projects and Apps یا بخش مدیریت اپ‌ها بگردید. اگه پنل از شما کاربرد پروژه رو پرسید، توضیح بدید که اپ فقط اطلاعات عمومی حساب خودتون رو برای نمایش در سایت می‌خونه.

ساخت اپ و انتخاب سطح دسترسی مناسب

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

قبل از ادامه، صفحه طرح و میزان مصرف رو در حساب خودتون بررسی کنید. دسترسی به endpoint موردنیاز، سهمیه درخواست و هزینه دقیق باید داخل پنل شما تأیید بشه. endpoint همون نشانی مشخص API هست که درخواست رو دریافت می‌کنه.

دریافت و نگهداری امن کلیدها و توکن

بعد از ساخت اپ، بخش Keys and Tokens رو باز کنید و Bearer Token رو بگیرید. Bearer Token یک رمز محرمانه‌ست که به درخواست وردپرس اجازه می‌ده با هویت اپ شما به X API وصل بشه. این مقدار رو در نوشته، برگه، شورت‌کد یا فایل قابل دانلود نذارید.

توکن رو همون لحظه در یک ابزار امن مدیریت رمز نگه دارید. اگه فکر می‌کنید توکن دیده شده، اون رو از پنل X دوباره تولید کنید و مقدار قبلی رو کنار بذارید. تصویر یا متن کامل صفحه کلیدها رو هم برای کسی نفرستید.

پیدا کردن شناسه حساب X

تفاوت نام کاربری و شناسه عددی حساب

نام کاربری همون عبارتیه که بعد از علامت @ می‌بینید و ممکنه صاحب حساب اون رو عوض کنه. شناسه کاربر یک عدد ثابت برای همون حسابه. برای این آموزش لازم نیست شناسه عددی رو از قبل بدونید، چون endpoint جست‌وجو با نام کاربری می‌تونه اطلاعات حساب رو مستقیم برگردونه.

نام کاربری رو بدون @ وارد کنید. برای نمونه، اگه نشانی پروفایل https://x.com/example باشه، نام کاربری موردنیاز کد فقط example هست.

گرفتن شناسه کاربر با X API

برای پیدا کردن اطلاعات حساب براساس نام کاربری، درخواست به مسیر زیر فرستاده می‌شه. پارامتر user.fields=public_metrics از API می‌خواد آمار عمومی حساب رو هم داخل پاسخ بذاره:

GET https://api.x.com/2/users/by/username/USERNAME?user.fields=public_metrics

در پاسخ موفق، مقدار data.id شناسه عددی حسابه و مقدار data.public_metrics.followers_count تعداد فالوورها رو نشون می‌ده. ساختار دقیق پاسخ و دسترسی endpoint رو قبل از انتشار روی سایت اصلی با اپ خودتون آزمایش کنید.

اضافه‌کردن قابلیت دریافت تعداد فالوورها به وردپرس

بهترین محل برای قراردادن کد

برای اینکه کد با عوض‌شدن یا به‌روزرسانی قالب از بین نره، یک افزونه کوچک بسازید. وارد فایل منیجر هاست بشید و پوشه wp-content/plugins رو باز کنید. داخل اون پوشه‌ای با نام mihanwp-x-followers بسازید و بعد یک فایل به نام mihanwp-x-followers.php داخلش قرار بدید.

توکن رو بهتره بیرون از فایل افزونه نگه دارید. فایل wp-config.php رو باز کنید و خط زیر رو قبل از خط پایان ویرایش فایل بذارید. عبارت نمونه رو با Bearer Token واقعی خودتون عوض کنید:

define( 'MIHANWP_X_BEARER_TOKEN', 'PASTE_YOUR_BEARER_TOKEN_HERE' );

دسترسی عمومی به فایل wp-config.php باید از طرف هاست مسدود باشه. اگه هاستتون امکان تعریف متغیر محیطی یا Secret داره، نگهداری توکن در اون بخش انتخاب بهتریه. در اون حالت، روش خواندن مقدار رو از پشتیبانی همون هاست بپرسید.

ساخت درخواست امن با توابع داخلی وردپرس

کد کامل زیر رو داخل فایل افزونه بذارید. این کد از تابع داخلی wp_remote_get() استفاده می‌کنه، گواهی HTTPS رو بررسی می‌کنه، ورودی نام کاربری رو پاک‌سازی می‌کنه و عدد رو برای یک ساعت در حافظه موقت نگه می‌داره:

<?php/** * Plugin Name: MihanWP X Followers Count * Description: نمایش تعداد فالوورهای یک حساب X با شورت‌کد. * Version: 1.0.0 */if ( ! defined( 'ABSPATH' ) ) {    exit;}function mihanwp_get_x_followers_count( $username ) {    $username = ltrim( sanitize_text_field( $username ), '@' );    if ( '' === $username ) {        return new WP_Error( 'missing_username', 'نام کاربری X وارد نشده.' );    }    if ( ! defined( 'MIHANWP_X_BEARER_TOKEN' ) || '' === MIHANWP_X_BEARER_TOKEN ) {        return new WP_Error( 'missing_token', 'توکن دسترسی X تنظیم نشده.' );    }    $cache_key = 'mihanwp_x_followers_' . md5( strtolower( $username ) );    $cached    = get_transient( $cache_key );    if ( false !== $cached ) {        return absint( $cached );    }    $endpoint = add_query_arg(        array( 'user.fields' => 'public_metrics' ),        'https://api.x.com/2/users/by/username/' . rawurlencode( $username )    );    $response = wp_remote_get(        $endpoint,        array(            'timeout' => 15,            'headers' => array(                'Authorization' => 'Bearer ' . MIHANWP_X_BEARER_TOKEN,                'Accept'        => 'application/json',            ),        )    );    if ( is_wp_error( $response ) ) {        return new WP_Error( 'x_request_failed', 'ارتباط با X API برقرار نشد.' );    }    $status_code = wp_remote_retrieve_response_code( $response );    $body        = wp_remote_retrieve_body( $response );    $data        = json_decode( $body, true );    if ( 200 !== $status_code ) {        return new WP_Error(            'x_api_error',            'X API پاسخ موفقی برنگردوند.',            array( 'status' => $status_code )        );    }    if (        ! is_array( $data ) ||        ! isset( $data['data']['public_metrics']['followers_count'] ) ||        ! is_numeric( $data['data']['public_metrics']['followers_count'] )    ) {        return new WP_Error( 'invalid_x_response', 'پاسخ X API ساختار مورد انتظار رو نداره.' );    }    $followers_count = absint( $data['data']['public_metrics']['followers_count'] );    set_transient( $cache_key, $followers_count, HOUR_IN_SECONDS );    return $followers_count;}function mihanwp_x_followers_shortcode( $atts ) {    $atts = shortcode_atts(        array(            'username' => '',            'link'     => 'yes',        ),        $atts,        'x_followers'    );    $username = ltrim( sanitize_text_field( $atts['username'] ), '@' );    $count    = mihanwp_get_x_followers_count( $username );    if ( is_wp_error( $count ) ) {        if ( current_user_can( 'manage_options' ) && defined( 'WP_DEBUG' ) && WP_DEBUG ) {            return '<span class="x-followers-error">' . esc_html( $count->get_error_message() ) . '</span>';        }        return '';    }    $label = number_format_i18n( $count ) . ' دنبال‌کننده در X';    if ( 'yes' === strtolower( $atts['link'] ) ) {        $profile_url = 'https://x.com/' . rawurlencode( $username );        return sprintf(            '<a class="x-followers-count" href="%1$s" target="_blank" rel="noopener noreferrer">%2$s</a>',            esc_url( $profile_url ),            esc_html( $label )        );    }    return '<span class="x-followers-count">' . esc_html( $label ) . '</span>';}add_shortcode( 'x_followers', 'mihanwp_x_followers_shortcode' );

حالا وارد پیشخوان وردپرس بشید و از مسیر «افزونه‌ها ← افزونه‌های نصب‌شده»، افزونه MihanWP X Followers Count رو فعال کنید. اگه بعد از فعال‌سازی خطای فنی دیدید، فایل رو از همون پوشه افزونه موقتاً تغییر نام بدید و کد رو از نظر ناقص‌بودن یا تغییر ناخواسته بررسی کنید.

خواندن تعداد فالوورها از پاسخ API

تابع wp_remote_retrieve_body() بدنه پاسخ رو می‌گیره و json_decode() اون رو به آرایه PHP تبدیل می‌کنه. بعد کد دنبال مسیر data → public_metrics → followers_count می‌گرده. قبل از استفاده از عدد، وجود فیلد و عددی‌بودن مقدار هم بررسی می‌شه.

این بررسی مهمه، چون هر پاسخ JSON لزوماً یک پاسخ موفق نیست. ممکنه X یک پیام خطا با ساختاری متفاوت برگردونه. اگه بدون بررسی مستقیم سراغ followers_count بریم، سایت اخطار PHP نشون می‌ده یا عدد اشتباهی ذخیره می‌کنه.

مدیریت خطا، محدودیت درخواست و پاسخ نامعتبر

کد اول خطاهای ارتباطی وردپرس رو با is_wp_error() بررسی می‌کنه. بعد کد وضعیت HTTP رو می‌خونه. کد ۲۰۰ یعنی درخواست موفق بوده، ولی کدهایی مثل ۴۰۱، ۴۰۳، ۴۰۴ و ۴۲۹ معمولاً به توکن، دسترسی، نام کاربری یا محدودیت مصرف مربوط می‌شن.

پیام و بدنه کامل پاسخ API نباید به بازدیدکننده نشون داده بشه، چون ممکنه اطلاعات فنی حساسی داخل اون باشه. نمونه بالا در حالت عادی چیزی نمایش نمی‌ده. فقط مدیر سایت و اون هم وقتی WP_DEBUG روشن باشه، یک پیام کوتاه و بدون توکن می‌بینه.

ذخیره موقت تعداد فالوورها با Transient API

تابع get_transient() اول دنبال عدد ذخیره‌شده می‌گرده. اگه مقدار هنوز معتبر باشه، همون عدد برگردونده می‌شه و درخواست تازه‌ای به X نمی‌ره. وقتی حافظه موقت تموم بشه، کد عدد جدید رو می‌گیره و با set_transient() برای یک ساعت دیگه نگه می‌داره.

یک ساعت فقط مقدار پیشنهادی این نمونه‌ست. اگه تعداد فالوورها لازم نیست خیلی زود تازه بشه، می‌تونید HOUR_IN_SECONDS رو با 6 * HOUR_IN_SECONDS عوض کنید. فاصله بیشتر، تعداد درخواست‌ها و هزینه احتمالی رو کم می‌کنه.

نمایش تعداد فالوورها در بخش دلخواه سایت

ساخت شورت‌کد برای استفاده داخل نوشته یا برگه

شورت‌کد یک عبارت کوتاه داخل کروشه‌ست که وردپرس اون رو به خروجی واقعی تبدیل می‌کنه. یک بلوک «شورت‌کد» به نوشته یا برگه اضافه کنید و عبارت زیر رو داخلش بذارید. به‌جای mihanwp نام کاربری خودتون رو بدون علامت @ بنویسید:

[x_followers username="mihanwp"]

این حالت عدد رو همراه با عبارت «دنبال‌کننده در X» نشون می‌ده و خروجی رو به پروفایل وصل می‌کنه. اگه فقط متن بدون لینک می‌خواید، ویژگی link="no" رو اضافه کنید:

[x_followers username="mihanwp" link="no"]

نمایش تعداد فالوورها در ابزارک، هدر یا فوتر

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

اگه محل موردنظر فقط کد PHP قبول می‌کنه، می‌تونید شورت‌کد رو با تابع do_shortcode() اجرا کنید. قبل از ویرایش فایل قالب حتماً از قالب فرزند استفاده کنید. راهنمای نمایش شورت‌کد در قالب وردپرس جزئیات این روش رو توضیح می‌ده.

<?php echo do_shortcode( '[x_followers username="mihanwp"]' ); ?>

قالب‌بندی عدد و اضافه‌کردن لینک پروفایل X

تابع number_format_i18n() عدد رو براساس زبان وردپرس قالب‌بندی می‌کنه. تابع esc_html() متن خروجی و esc_url() نشانی پروفایل رو هم قبل از نمایش ایمن می‌کنن. ویژگی‌های noopener و noreferrer برای لینک‌هایی هستن که در برگه تازه باز می‌شن.

برای تغییر ظاهر خروجی می‌تونید کلاس x-followers-count رو در بخش «نمایش ← سفارشی‌سازی ← CSS اضافی» هدف بگیرید. برای نمونه:

.x-followers-count {    display: inline-block;    padding: 8px 14px;    border-radius: 8px;    background: #000;    color: #fff;    text-decoration: none;}

چطور درست‌بودن نمایش تعداد فالوورها رو بررسی کنید؟

1. اول شورت‌کد رو داخل یک برگه آزمایشی بذارید و پیش‌نمایش رو باز کنید.
2. عدد نمایش‌داده‌شده رو با تعداد فالوورهای پروفایل X مقایسه کنید. اختلاف کوتاه‌مدت به‌خاطر حافظه موقت طبیعیه.
3. اگه چیزی نمایش داده نشد، مطمئن بشید افزونه فعاله، نام کاربری بدون @ نوشته شده و ثابت توکن در wp-config.php قرار گرفته.
4. برای بررسی فنی، گزارش خطای وردپرس رو موقتاً فعال کنید؛ ولی فایل گزارش رو عمومی نذارید.
5. بعد از پیدا کردن مشکل، حالت نمایش خطا رو در سایت اصلی خاموش کنید.

برای آزمایش پاسخ خام API بهتره از ابزار آزمایش داخل مستندات X یا یک ابزار توسعه امن استفاده کنید. توکن رو داخل سرویس‌های ناشناس وارد نکنید و پاسخ کامل API رو هم در صفحه عمومی سایت نذارید.

اگه نام کاربری، توکن یا زمان ذخیره موقت رو تغییر دادید و هنوز مقدار قبلی دیده می‌شه، Transient مرتبط رو پاک کنید. می‌تونید افزونه رو یک‌بار غیرفعال و دوباره فعال کنید، یا با ابزار مدیریت پایگاه داده فقط کلید موقت مربوط به همین افزونه رو حذف کنید. قبل از تغییر مستقیم پایگاه داده نسخه پشتیبان بگیرید.

خطاهای رایج و راه‌حل اون‌ها

توکن یا کلید دسترسی معتبر نیست

خطای ۴۰۱ معمولاً یعنی توکن ارسال نشده، ناقصه یا اعتبار لازم رو نداره. مقدار ثابت MIHANWP_X_BEARER_TOKEN رو بررسی کنید و مطمئن بشید فاصله یا علامت اضافه‌ای اول و آخر توکن نیست. اگه توکن رو دوباره ساخته‌اید، مقدار قبلی داخل wp-config.php رو هم عوض کنید.

سطح دسترسی اجازه خواندن اطلاعات کاربر رو نمی‌ده

خطای ۴۰۳ می‌تونه به سطح دسترسی اپ، وضعیت پروژه یا طرح API مربوط باشه. داخل پنل توسعه‌دهنده بررسی کنید که اپ اجازه خواندن اطلاعات عمومی کاربران و دسترسی به endpoint مورد استفاده رو داره. اگه طرح فعلی این مسیر رو پوشش نمی‌ده، باید طرح یا روش اجرا رو تغییر بدید.

تعداد فالوورها به‌روز نمی‌شه

اول یادتون باشه عدد برای یک ساعت ذخیره می‌شه؛ پس تغییر فوری دیده نمی‌شه. بعد از پایان زمان حافظه موقت، صفحه رو دوباره باز کنید. اگه عدد همچنان ثابت موند، کش وردپرس، کش هاست و شبکه توزیع محتوا رو هم پاک کنید.

محدودیت مصرف یا هزینه API مشکل ایجاد کرده

کد وضعیت ۴۲۹ معمولاً به تعداد زیاد درخواست‌ها مربوطه. داشبورد مصرف اپ رو بررسی کنید و زمان حافظه موقت رو بیشتر کنید. اگه فقط یک عدد تقریبی برای معرفی حساب می‌خواید، شاید هزینه و نگهداری API ارزشش رو نداشته باشه و لینک ساده پروفایل انتخاب بهتری باشه.

نام کاربری یا شناسه حساب اشتباهه

نام کاربری رو بدون @ و بدون نشانی کامل پروفایل وارد کنید. اگه صاحب حساب نام کاربری رو عوض کرده، شورت‌کد هم باید به‌روز بشه. خطای ۴۰۴ یا پاسخ بدون داده می‌تونه نشونه اشتباه‌بودن نام کاربری یا در دسترس نبودن حساب باشه.

نکات امنیتی مهم برای محافظت از کلیدهای X API

• توکن رو داخل نوشته، برگه، شورت‌کد، فایل CSS یا JavaScript نذارید.
• توکن واقعی رو داخل مخزن عمومی GitHub یا فایل قابل دانلود قرار ندید.
• بررسی گواهی HTTPS رو غیرفعال نکنید. گزینه‌هایی مثل sslverify => false امنیت اتصال رو پایین میارن.
• پاسخ کامل API، هدر Authorization و توکن رو داخل پیام خطای عمومی نشون ندید.
• فقط دسترسی خواندن لازم رو به اپ بدید و مجوزهای اضافی رو فعال نکنید.
• اگه توکن فاش شد، سریع اون رو دوباره تولید کنید و مقدار قبلی رو کنار بذارید.
• فایل‌ها، پایگاه داده و تنظیمات اپ رو قبل از هر تغییر مهم پشتیبان‌گیری کنید.

استفاده از توابع HTTP داخلی وردپرس کمک می‌کنه اتصال با تنظیمات استاندارد خود وردپرس انجام بشه. ساخت درخواست با روش‌های دستی یا خاموش‌کردن بررسی SSL شاید یک خطا رو موقتاً پنهان کنه، ولی راه‌حل امنی نیست.

راه ساده‌تر بدون استفاده از X API

اضافه‌کردن لینک پروفایل X به سایت

اگه هدفتون فقط هدایت بازدیدکننده‌ها به حساب X هست، یک دکمه یا لینک ساده معمولاً کافی و کم‌دردسرتره. این روش توکن، هزینه API، کدنویسی و نگهداری دوره‌ای نمی‌خواد. متن دکمه رو روشن بنویسید؛ مثلاً «ما رو در X دنبال کنید».

نمایش عدد فالوورها به‌تنهایی تضمین نمی‌کنه کاربران بیشتری شما رو دنبال کنن یا رتبه سئوی سایت بهتر بشه. شبکه‌های اجتماعی می‌تونن به دیده‌شدن محتوا و جذب بازدیدکننده کمک کنن، ولی تعداد فالوورها یک عامل مستقیم و تضمینی برای رتبه گوگل نیست.

استفاده از ابزار رسمی جاسازی X

اگه می‌خواید پست یا تایم‌لاین عمومی رو داخل سایت نشون بدید، می‌تونید از ابزار رسمی انتشار X استفاده کنید. نشانی محتوای عمومی رو وارد کنید، نوع نمایش رو انتخاب کنید و کد پیشنهادی رو در بلوک HTML سفارشی وردپرس بذارید.

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

چه زمانی بهتره تعداد فالوورها رو نمایش ندید؟

اگه عدد فالوورها برای تصمیم بازدیدکننده ارزش مشخصی نداره، نمایش اون فقط صفحه رو شلوغ می‌کنه. برای یک سایت تازه، معرفی نوع محتوای حساب و یک دعوت روشن مثل «آموزش‌های کوتاه ما رو در X ببینید» معمولاً از نمایش یک عدد تنها مفیدتره.

همچنین اگه نمی‌خواید هزینه و تغییرات احتمالی API رو پیگیری کنید، بهتره سراغ روش بدون API برید. برای نمایش شمارنده چند شبکه اجتماعی هم می‌تونید راهنمای نمایش تعداد فالوور شبکه‌های اجتماعی در وردپرس رو ببینید؛ ولی قبل از انتخاب هر ابزار، سازگاری و دسترسی فعلی اون به شبکه موردنظر رو بررسی کنید.

جمع‌بندی

برای نمایش تعداد فالوور X در وردپرس، اول به یک اپ در پنل توسعه‌دهنده و Bearer Token نیاز دارید. بعد وردپرس اطلاعات عمومی حساب رو از X API می‌گیره، مقدار followers_count رو جدا می‌کنه و اون رو با یک شورت‌کد نشون می‌ده. ذخیره موقت نتیجه هم تعداد درخواست‌ها، زمان انتظار و هزینه احتمالی رو پایین میاره.

توکن رو محرمانه نگه دارید، بررسی HTTPS رو خاموش نکنید و پیام کامل API رو به بازدیدکننده نشون ندید. اگه فقط می‌خواید کاربران وارد پروفایلتون بشن، لینک ساده یا ابزار رسمی جاسازی X انتخاب راحت‌تریه و نگهداری کمتری می‌خواد.

سؤال‌های متداول

تیم تولید محتوا

ما در تیم تولید محتوای میهن وردپرس در تلاش هستیم تا بهترین مقالات آموزشی در زمینه وردپرس و کسب‌و‌کارهای اینترنتی را تهیه کنیم. صحت محتوای این صفحه توسط رضا راد بررسی خواهد شد.