תוסף פשוט ל-NodeBB שמחליף תצוגת תאריכים לגרסה עברית.
הוא עומד באמצעות:
- סקריפט בצד הלקוח ב-
public/hebrewdate.jsשסורק תגיותtime/spanומאחד תאריכים. - בקשה POST ל-
/api/plugins/hebrewdate/convertשמחזירה מיפוי תאריך לועזי -> תאריך עברי באמצעות Hebcal API. - Middleware להסגירה אוטומטית של הפורום בשבת, עם אפשרות לדילוג למנהל/ממ"ד באמצעות כותרות או הרשאות משתמש.
ה-repository ב-GitHub הוא רק המקור של התוסף, ולא ה-plugin שכבר מותקן בסביבת ה-NodeBB שלך.
NodeBB בודק תוספים שמותקנים בתוך פרויקט ה-NodeBB עצמו, בדרך כלל ב-node_modules או במיקום התוסף של ההתקנה, ולא רק במאגר GitHub.
לכן, גם אם יש plugin.json, library.js ו-package.json ב-GitHub, התוסף לא יופיע באדמין של NodeBB עד שהוא יותקן, נבנה מחדש, וירוץ בתוך סביבת ה-NodeBB.
cd /path/to/nodebb
npm install git+https://github.com/amer-raba/nodebb-plugin-hebrewdate.git
./nodebb build
./nodebb restart- העתק את התיקייה של התוסף לתוך
node_modulesבתוך שורש NodeBB, או שמור אותו במקום המתאים לפריסה שלך. - התקן את התלות:
cd /path/to/nodebb npm install - בנה והפעל מחדש:
./nodebb build ./nodebb restart
ה-plugin יכול לסגור את הפורום אוטומטית משעה 18:00 ביום שישי ועד תחילת הפעילות מחדש לאחר השבת.
NODEBB_SHABBAT_ENABLED=true— הפעל/השבת את הסגירה.NODEBB_SHABBAT_START_HOUR=18— שעה שבה מתחילה הסגירה ביום שישי.NODEBB_HEBREWDATE_REMOTE=false— השבתת המרה של תאריכים דרך Hebcal.
- מנהלי פורום ו-
uid === 1יכולים להיכנס גם בשבת. - אפשר לעבור את חובת הסגירה גם דרך כותרת HTTP:
x-nodebb-admin: truex-nodebb-shabbat-bypass: true
- לכל בקשה מוגבל מקסימום 100 תאריכים.
- המרה מבוצעת ב־4 בקשות במקביל לכל היותר.
- יש מטמון במטמון זיכרון (TTL של שעה) כדי למנוע חישוב חוזר.
- אפשר להשבית את ה-API החיצוני על ידי הגדרת משתנה סביבה:
NODEBB_HEBREWDATE_REMOTE=false. - בקלט לא תקין מוחזר כ־400 עם הודעה כללית, ולא עם שגיאת שרת פנימית.
ה-plugin טוען את ה-script אוטומטית דרך plugin.json ו-scripts, כך שאין צורך להוסיף אותו ידנית לכותרת האתר.
אם תרצה עדיין להוסיף ידנית, אפשר להשתמש ב:
<script src="/plugins/nodebb-plugin-hebrewdate/static/hebrewdate.js"></script>- התוסף משתמש ב-Hebcal API לצורך המרה של תאריכים.
- אם Hebcal אינו זמין, הוא ישאר על התאריך המקורי במקום להתרסק.
- תאריך נשמר באמצעות תצורת אזור זמן מקומי כדי למנוע שגיאת
toISOString()בעת חישוב תאריך יום לפני/אחרי.