# أساليب التلعيب ## طرق التحفيز في إنستغرام وفيسبوك {% hint style="warning" %} لتكوين عمليات الدوال، نوصي باستخدام التحفيز[ القالب لمحادثات إنستغرام كمرجع](#gamification-methods-in-instagram-and-facebook). {% endhint %} لاستخدام الدوال المدرجة أدناه، تحتاج إلى تعريف متغيرات مشتركة في **إعدادات المشروع**:
اسم المتغيرغرض المتغيرالقيمة، مثال
comment_scoreعدد النقاط التي تُمنح للتعليقات10
comment_max_actions الحد الأقصى لعدد التعليقات يوميًا5
min_comment_lenالحد الأدنى لطول التعليق25
stories_scoreعدد النقاط التي تُمنح للتفاعلات في القصص15
stories_max_actionsالحد الأقصى لعدد الإجراءات يوميًا1
stories_mention_scoreعدد النقاط التي تُمنح للإشارات في القصص5
stories_mention_max_actionsالحد الأقصى لعدد الإجراءات يوميًا2
post_mention_scoreعدد النقاط التي تُمنح للإشارات في المنشور10
post_mention_max_actionsالحد الأقصى لعدد الإجراءات يوميًا3
end_game_dateتاريخ انتهاء اللعبة30.12.2021
**game\_add\_comment**(text=None) - يضيف نقاطًا لتعليق على إنستغرام أو فيسبوك؛ يمكنك أيضًا تمرير أي نص. **game\_add\_stories**() - يضيف نقاطًا للتفاعلات في القصص **game\_add\_message**() - يضيف نقاطًا للرسائل المباشرة **game\_add\_stories\_mention**() - يضيف نقاطًا للإشارات في القصص **game\_get\_user\_score**() - يعرض نقاط المستخدم **game\_get\_user\_place**() - يعرض موقع المستخدم في الترتيب **game\_get\_leader\_score**() - يعرض نقاط المتصدر في الترتيب **game\_get\_top(count=99999999, shift=0, humanize=False, delimiter=None, platform=None)** - استدعاء الدالة بدون معاملات يُرجع ترتيبًا مصنفًا كمصفوفة من المستخدمين. تقبل الدالة المعاملات الخمسة التالية: **count** - عدد المستخدمين المطلوب إرجاعهم؛ **shift** - موضع البداية في الترتيب للاختيار (0 يعني أن القائمة تبدأ من المتصدر وتتجه نزولًا حسب النقاط؛ على سبيل المثال، 3 يعني أن الاختيار يبدأ من المركز الرابع وما دونه)؛ **humanize** **0** - يُرجع مصفوفة من قواميس المستخدمين، **1** يعرض قائمة منسقة لعرضها للمستخدم؛ **delimiter** - الفاصل بين اسم المستخدم ونتيجته (يُستخدم إذا **humanize=1**); **platform 1** - يعرض اسم تسجيل الدخول في إنستغرام (مثل، **@nik**بدلاً من اسم المستخدم. المثال 1: game\_get\_top(10, 0, 1, ' - ') سيُرجع: John - 40 Anna - 30 George - 10\ \ المثال 2: game\_get\_top(3, 0, 1, ' - ', 1) سيُرجع: @john - 40 @anna - 30 @privet - 10 **game\_add\_score**(count=1, client\_id=None) - يضيف نقاطًا إلى المستخدم **game\_set\_score**(score, client\_id=None) - يعيّن إجمالي نقاط المستخدم **game\_ban\_player**() - يحظر المستخدم **game\_unban\_player**() - يرفع الحظر عن المستخدم **game\_user\_banned**() - يُرجع حالة حظر المستخدم؛ True إذا كان محظورًا، وFalse إذا لم يكن \# يسمح بالعمل مع قيم عشوائية في لوحة الصدارة. **game\_add\_value**(val\_name, count=1, client\_id=None) - **game\_set\_value**(val\_name, value, client\_id=None) {% hint style="info" %} إذا لم يتم توفير **client\_id** غير مُحدد، فستعمل الدالة مع العميل الحالي. {% endhint %} **game\_minus\_user\_score**(count =10) - يخصم نقاطًا من المستخدم (**count** - عدد النقاط المطلوب خصمها) **game\_get\_today\_user\_comment\_action**() - عدد التعليقات التي نشرها المستخدم اليوم **game\_get\_today\_user\_message\_actions**() - عدد الرسائل التي أرسلها المستخدم اليوم **game\_get\_today\_user\_stories\_actions**() - عدد القصص التي نشرها المستخدم اليوم **game\_get\_today\_user\_mention\_actions**() - عدد أنشطة المستخدم (الإشارات) اليوم **game\_get\_today\_user\_post\_mention\_actions**() - عدد المنشورات التي تحتوي على إشارات من المستخدم اليوم **game\_get\_total\_comment\_action**() - إجمالي عدد التعليقات خلال اللعبة بأكملها **game\_get\_total\_message\_actions**() - إجمالي عدد الرسائل خلال اللعبة بأكملها **game\_get\_total\_stories\_actions**() - إجمالي عدد القصص خلال اللعبة بأكملها **game\_get\_total\_stories\_mention\_actions()** - إجمالي عدد الإشارات في القصص خلال اللعبة بأكملها **game\_get\_total\_post\_mention\_actions()** - إجمالي عدد الإشارات في المنشورات خلال اللعبة بأكملها ## الحصول على الترتيب في تيليغرام {% hint style="warning" %} لتكوين عمليات الدوال، نوصي باستخدام التحفيز[ القالب لمحادثات تيليغرام كمرجع](#getting-ranking-in-telegram). {% endhint %} في المتغيرات العامة، يجب إنشاء قاموس باسم tg\_thanks\_score\_data لتخزين معلومات العميل بالتنسيق التالي: `{"total_thanks":20,"326659632":{"name":"John","user_name":"john","score":5},"403051597":{"name":"Timm","user_name":"dbeing","score":15,"banned":false}}` **tg\_get\_top(count=99999999, shift=0, humanize=False, delimiter=None)** المعلمات: **count** - عدد المستخدمين المطلوب إرجاعهم\ **shift** - موضع البداية في الترتيب للاختيار (0 يعني أن القائمة تبدأ من المتصدر وتتجه نزولًا حسب النقاط؛ على سبيل المثال، 3 يعني أن الاختيار يبدأ من المركز الرابع وما دونه)\ **humanize** - 0 يُرجع مصفوفة من قواميس المستخدمين، و1 يُرجع قائمة منسقة لعرضها للمستخدم\ **delimiter** - الفاصل بين اسم المستخدم ونتيجته (يُستخدم إذا كان humanize=1) **tg\_get\_user\_info()** {'score': user\_score, 'place': place, 'name': name} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/ar/chatbot/functions/alaalh-alhasbh/gamification.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.