Devenia Social Sharing: أزرار مشاركة تعمل محليًا

قدّموا للقراء أزرار مشاركة تعمل بالكامل على موقع WordPress الخاص بكم. لا تجلب الإضافة أي موارد خارجية لعرض الأزرار. أنشأنا هذه النسخة المشتقة لإضافة دعم اللغات الذي كانت تحتاج إليه مواقعنا متعددة اللغات.
مقال متصل برمز مشاركة يتكون من ثلاث نقاط.

الموقع ينشئ الأزرار، والقارئ يفتح الوجهة

ينشئ WordPress روابط المشاركة والأيقونات محليًا. لا تحتاج الأزرار إلى خدمة من طرف ثالث لإنشائها أو عرضها؛ فلا تُحمَّل ملفات برمجية أو خطوط أو أيقونات أو عناصر مضمّنة أو حزم SDK من الخارج.

وهكذا تعمل وظيفة المشاركة دون الاعتماد على مزوّد خارجي ما دام القارئ على صفحتكم.

لا تُفتح الشبكة أو تطبيق المراسلة المحدد إلا عندما يختار القارئ رابط المشاركة، ويكون عنوان المقال جاهزًا للاستخدام. عندها تسري قواعد خدمة الوجهة. لا تنشر الإضافة نيابةً عن القارئ، ولا تحصي المشاركات المكتملة.

قارئ يختار مسار البريد الإلكتروني لمشاركة مقال، بينما تبقى المسارات الأخرى غير مفعلة.

تُنشأ روابط المشاركة محليًا. لا تُفتح إلا الوجهة التي يختارها القارئ، وتبقى الاتصالات الأخرى غير نشطة.

ضعوا خيار المشاركة حيث يحتاج إليه القارئ

استخدموا موضعًا ثابتًا للمقالات المعتادة، أو اختاروا نقطة محددة داخل صفحة طويلة.

بعد المقال

يمنح وضع الروابط تلقائيًا بعد المحتوى خطوة مفيدة لمن أكمل قراءة الدليل. ويمكن أيضًا وضعها قبل المحتوى. يُحدد الموضع لكل نوع من أنواع المحتوى.

داخل الصفحة

استخدموا مكوّن المشاركة أو الكود القصير [devenia_share]. يمكن لكل مكوّن أو كود قصير اختيار شبكاته وعنوانه الخاص. ترك العنوان فارغًا يُبقي الروابط دون إظهار عنوان.

تجنبوا ظهور مجموعتين من الأزرار

قد تظهر الروابط المدرجة يدويًا والروابط الموضوعة تلقائيًا معًا. عطّلوا الموضع التلقائي لنوع المحتوى إذا أردتم استخدام المكوّن أو الكود القصير وحده. يمكن استثناء كل مقالة على حدة، بينما تتبع الصفحات إعداد نوع المحتوى.

اختاروا الخدمات التي يستخدمها قراؤكم

تشمل الخيارات X وFacebook وLinkedIn وBluesky وReddit وPinterest وTelegram وWhatsApp والبريد الإلكتروني والرسائل النصية SMS. تختارون الخدمات وترتيبها، ولا يلزم إظهارها جميعًا.

تحققوا من متطلبات الوجهة

يحتاج Pinterest إلى صورة. وتحتاج روابط البريد الإلكتروني والرسائل النصية إلى تطبيق متوافق على جهاز القارئ. لا يضمن رابط المشاركة الصورة أو النص الذي تعرضه الشبكة في المعاينة. ولا تقوم الإضافة بجدولة المنشورات أو قياس المشاركات المكتملة.

أكملوا الإعداد قبل انتظار ظهور الأزرار

عند التفعيل الأول، لا تكون هناك شبكات أو مواضع تلقائية محددة. يتطلب الإعداد مطورًا أو تكاملًا يستطيع استدعاء وظائف WordPress Abilities API. لا توجد شاشة إعدادات عامة في wp-admin.

1. قراءة الإعدادات وحفظها

استدعوا devenia-social-sharing/get-settings، ثم أرسلوا كائن الإعدادات كاملًا إلى devenia-social-sharing/update-settings. تتطلب الوظيفتان صلاحية manage_options. أدرجوا القيم التي تريدون الاحتفاظ بها، لأن كل تحديث يستبدل الإعدادات كلها.

2. كتابة النصوص

اكتبوا عنوانًا وتسميات ملائمة لقارئات الشاشة للشبكات المختارة. يحتاج البريد الإلكتروني أيضًا إلى موضوع ونص رسالة يحتوي على عنصر نائب واحد بالضبط هو {url}. إذا غاب نص مطلوب، فلن تظهر روابط المشاركة.

3. فحص اللغات والأجهزة

يمكن لـPolylang حفظ ترجمات النصوص المحددة في الإعدادات. راجعوا الصياغة وعنوان المقال والوجهة في كل لغة. افحصوا الأزرار على الهاتف والكمبيوتر أيضًا، فالقالب هو الذي يتحكم في مظهرها.

إضافة صغيرة ذات مهمة واضحة

تتطلب ووردبريس 6.9 أو أحدث وPHP 7.4 أو أحدث. تستخدم الصفحة العامة روابط عادية وأيقونات SVG محلية. لا تضيف الإضافة ملف تنسيق أو JavaScript إلى الصفحة العامة، ويُستخدم JavaScript الخاص بها داخل محرر المكوّنات فقط.

يستطيع المطورون عرض منطقة مشاركة باستخدام devenia_social_sharing_render()، وفحص موضعها والنصوص المطلوبة باستخدام devenia_social_sharing_get_surface_manifest(). يتولى القالب التصميم المرئي، واستخدام Polylang اختياري.

لماذا أنشأنا هذه النسخة المشتقة؟

أنشأنا نسخة مشتقة من Scriptless Social Sharing لأن الإضافة الأصلية كانت تفتقر إلى دعم اللغات الذي تحتاج إليه مواقعنا متعددة اللغات. تضيف Devenia Social Sharing نصوص مشاركة تتوافق مع اللغة، وتدعم وظائف Polylang الأصلية لترجمة العناوين وتسميات إمكانية الوصول ونصوص البريد الإلكتروني.

الإضافة الأصلية من تطوير Robin Cornett. تحتفظ هذه النسخة بإشعارات حقوق النشر الأصلية وشروط ترخيص GPL-2.0-or-later.

مقال متصل برمز مشاركة يتكون من ثلاث نقاط.

أبقوا المشاركة محلية، وقدّموها بلغة القارئ

نزّلوا الإضافة، واختاروا وجهات المشاركة، وأدخلوا النصوص. أضيفوا الترجمات للغات التي تستخدمونها، ليحصل القراء على أزرار مشاركة تُحمَّل بالكامل من موقعكم.