פיתוח פרטי | ➕ מודול הוספת ושינוי ערכים מתקדם - כולל הוספת מספר מקליט ההודעה

[CUBASE]

שלום לכולם!

רבים מכם מכירים את המודול המובנה של "הוספת ערך לקובץ" (add_id_to_list). פיתחתי עבורכם גרסה משודרגת ב-API, שלוקחת את היכולות של המודול המובנה כמה צעדים קדימה ומביאה חידושים בלעדיים!

️ מה החידושים בגרסה המשודרגת?

1. שילוב מושלם בהשמעת קבצים (file_phone) : ניתן להגדיר שהמפתח או הערך יהיו מספר הטלפון של מקליט ההודעה שמושמעת באותו רגע!
2. הוספת סיומת קבועה (key_last / value_last) : מלבד הוספת טקסט לפני המפתח/הערך (first), ניתן כעת להוסיף טקסט קבוע גם אחריהם.
3. גמישות מלאה בסיומות קבצים: ניתן לערוך כל קובץ במערכת (כולל .ini, .txt או כל סיומת אחרת), שכן שם הקובץ מוגדר באופן מלא כולל הסיומת.
4. שמות פרמטרים קצרים ונוחים: ללא הקידומת הארוכה add_id_to_list_.

---

️ שלב 1: חיבור המודול והגדרת קובץ היעד

את המודול ניתן להגדיר כשלוחה עצמאית (type=api) או להטמיע אותו בתוך שלוחת השמעת קבצים (באמצעות control_playX / after_play).

הגדרות החיבור הבסיסיות:

type=api
api_link=https://moduls.smartel.workers.dev/add_id_to_list.php
api_add_0=token=הטוקן_שלכם

קביעת מיקום ושם הקובץ לעריכה (location_list) :
חובה להגדיר את הנתיב המלא של הקובץ כולל סיומת הקובץ (לדוגמה: id.ini/) :

api_add_1=location_list=/id.ini

אפשרות לבחירת השלוחה על ידי המאזין:
אם תרצו שהמאזין יקיש את מספר השלוחה שבה נמצא הקובץ (המערכת תבקש הקשת שלוחה):

api_add_1=location_list=TFR

ואז יש להגדיר את שם הקובץ בתיקיה שהמאזין בחר:

api_add_2=location_tfr_file_name=ext.ini

---

שלב 2: הגדרת ה-Key (המפתח)

המפתח הוא החלק שמופיע לפני סימן השווה.

בחירת סוג המפתח (key_type או key) :

• מפתח קבוע מראש:

api_add_X=key=מפתח

• מספר הטלפון/הזיהוי של המאזין הנכנס:

api_add_X=key_type=EnterID

(שימו לב: בשונה מהמודול המובנה, בגרסה זו חובה להגדיר במפורש EnterID אם רוצים את זיהוי המאזין).

• הקשת ספרות על ידי המאזין:

api_add_X=key_type=digits

(משמיע הודעה להקשת המפתח).

• הקלדה במקלדת (אותיות/ספרות):

api_add_X=key_type=keyboard

• בלעדי! מספר הטלפון של מקליט ההודעה:

api_add_X=key_type=file_phone

(פעיל בהשמעת קבצים - שולף אוטומטית את מספר הטלפון של מי שהקליט את הקובץ הנוכחי).

הוספת קידומת וסיומת קבועה למפתח:

• קידומת לפני המפתח:

api_add_X=key_first=SIP-

(תוצאה: SIP-Key)

• בלעדי! סיומת אחרי המפתח:

api_add_X=key_last=-OK

(תוצאה: Key-OK)

---

🟰 שלב 3: הגדרת ה-Value (הערך)

הערך הוא החלק שמופיע לאחר סימן השווה.

בחירת סוג הערך (value_type או value) :

• ערך קבוע מראש:

api_add_X=value=ערך

• מספר הטלפון/הזיהוי של המאזין הנכנס:

api_add_X=value_type=EnterID

• הקשת ספרות על ידי המאזין:

api_add_X=value_type=digits

• הקלדה במקלדת:

api_add_X=value_type=keyboard

• בלעדי! מספר הטלפון של מקליט ההודעה:

api_add_X=value_type=file_phone

הוספת קידומת וסיומת קבועה לערך:

• קידומת לפני הערך:

api_add_X=value_first=t-

(תוצאה: Key=t-Value)

• בלעדי! סיומת אחרי הערך:

api_add_X=value_last=-end

(תוצאה: Key=Value-end)

---

שלב 4: עדכון, שינוי ופעולות חשבון על ערכים קיימים

כברירת מחדל, המודול מוסיף שורה חדשה. אם המפתח כבר קיים בקובץ, המערכת תציג שגיאה.

שינוי ערך קיים (value_change) :
כדי לעדכן ערך של מפתח שכבר קיים בקובץ (למשל להחליף מ-0501234567=old ל-0501234567=new), הוסיפו:

api_add_X=value_change=yes

פעולות חשבון על ערכים מספריים (מונעים / מוני לייקים וכדומה):
אם הערך בקובץ הוא מספרי (למשל id=1), תוכלו להגדיר שהמערכת תעלה או תוריד את המספר ב-1:

• הוספת 1 לערך הקיים: api_add_X=value_plus=yes (מ-id=1 יהפוך ל-id=2)
• הורדת 1 מהערך הקיים: api_add_X=value_minus=yes (מ-id=2 יהפוך ל-id=1)
  (הערה: הגדרת מינוס גוברת על פלוס).

---

שלב 5: הגדרת ערך עם תוקף זמן (תפוגה אוטומטית)

תוכלו לקבוע שהערך שנוסף יישאר בתוקף לזמן מוגדר בלבד.
(שימו לב: תוקף זמן עובד כאשר מוגדרים גם מפתח וגם ערך).

הגדרת משך התוקף (value_expired) :

api_add_X=value_expired=4h

טבלת פורמטים לבחירת זמן תפוגה:

ערך זמן	תיאור	דוגמה
s	שניות	30s
m	דקות (אות קטנה)	15m
h	שעות	4h
d	ימים	2d
M	חודשים (אות גדולה!)	1M
YYYY-MM-DD	עד סוף תאריך מסוים	2026-12-31
YYYY-MM-DD HH:MM:SS	עד תאריך ושעה מדויקים	2026-12-31 23:59:59
HH:MM:SS	עד שעה מסוימת היום	18:00:00
none	ללא פקיעת תוקף (קבוע)	none

שינוי ערך אוטומטי לאחר פקיעת התוקף:
כברירת מחדל, הערך נמחק כשתוקפו פג. אם תרצו שיוחלף בערך אחר (למשל menu), הגדירו:

api_add_X=value_expired_change_to=menu

---

שלב 6: בדיקה בקובץ נוסף וניתוב בסיום

בדיקה בקובץ נוסף:
ניתן להגדיר שהמערכת תבדוק קודם אם המפתח קיים בקובץ נוסף. אם הוא קיים שם – המערכת תציג שגיאה ולא תרשום:

api_add_X=check_block_list=yes
api_add_X=location_list_block=/WhiteList.ini

קביעת לאן לעבור בסיום התהליך:

• לאן לעבור בסיום בהצלחה:

api_add_X=end_goto=/1

• לאן לעבור במקרה של שגיאה (למשל אם כבר רשום):

api_add_X=error_end_goto=/2

---

הודעות מערכת רלוונטיות למודול:

• M4350 - "אנא הקישו את השלוחה ממנה תרצו לקחת את הקובץ..."
• M4359 - "הנכם מועברים לכתיבת מפתח"
• M4360 - "הנכם מועברים לכתיבת ערך"
• M3410 - "מספרכם אינו רשאי להירשם, לבירורים פנו לאחראי"
• M3411 - "הרישום בוצע בהצלחה, שלום ותודה"
• M3949 - "אנא הקישו את המפתח הרצוי ובסיום הקישו סולמית"
• M4358 - "אנא הקישו את הערך הרצוי ובסיום הקישו סולמית"

בהצלחה לכולם! תהנו מהמודול המשודרג וספרו בתגובות איך עובד אצלכם!