מדריך | יצירת פורום NodeBB אופליין משלכם!

פלמנמוני

שלום לכולם

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

במדריך הזה נלמד כיצד ליצור בעצמנו פורום של NodeBB, שנוכל פעם אחת להרגיש בעצמנו מנהלי פורום (בינינו, מי לא רוצה להרגיש ככה לפחות פעם אחת... מקווה ש @שמואל ו @אלישי לא יפגעו... ).
כמובן תשאלו הרי אין לנו בכלל שרת ואין לנו דומיין וכו' אז איך נוכל לייצר פורום, אז זהו, שזה בדיוק החידוש של המדריך הזה שבו נלמד כיצד ליצור פורום אופליין (לא מקוון)! שיישב על שרת מקומי (מסד נתונים) על המחשב ולא על שרת חיצוני, וכמובן יהיו בו את כל האפשרויות של רישום משתמשים ואיזור ניהול וכו' (חוץ מאימות מייל וטלפון כמובן וכן כל מה שדורש קשר לשרת חיצוני).
התכלית בפורום כזה היא בעצם ללמוד ולהכיר את איזור הניהול עבור מי שמעוניין בכך ולהכיר את כל האפשרויות שהפורום נותן, וגם אפשר להשתמש בו כפורום פנימי לכלל המשתמשים באותו מחשב (לכאורה ניתן ג"כ לשים על כונן חיצוני והפורום יהיה נייד, אבל את זה לא ניסיתי) או אפי' בכל המחשבים המקושרים לאותה הרשת (אפשרות זו לא ניסיתי כך שיתכן שידרשו כמה שלבים נוספים אחרי המדריך לאפשר את האפשרות הזאת).

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

שימו לב כי הפורום עם מסד הנתונים הולך לזלול לכם כמה ג'יגות במחשב, קחו בחשבון אם אתם רוצים לשמור אותו לטווח ארוך.

אבקש מאוד לא להגיב פה אלא רק בנושא התגובות פה.

ובכן, נתחיל-

שלב א' – יצירת מסד הנתונים

דבר ראשון נתחיל עם יצירת מסד הנתונים עליו יישב הפורום.

יש להוריד Node.js גירסה 18, ניתן גם להוריד מהאתר הרשמי, שימו לב גירסאות חדשות יותר לא בהכרח יתאימו.
יש להפעיל את הקובץ.

כעת יש להוריד MongoDB
קישור ישיר להורדת הגירסה האחרונה מהאתר הרשמי.
יש להפעיל את הקובץ.
בעת ההתקנה:
סמן Install MongoDB as a service
בחר Run the service as Network Service user

שלב ב' – התקנת הקוד של NodeBB

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

C:\Users\Public

כל ההדרכות, הנתיבים והסקריפטים דלהלן מכוונים לתיקייה זו, מי ששם במקום אחר שיפקח את עיניו וליבו להלן לשנות הכל לפי התיקייה שלו (גם המוריד את התיקייה הנ"ל עליו לשים לב שלא יופיע בנתיב פעמיים NodeBB).
התיקייה הנ"ל הינה לאחר כמה וכמה שינויים מהמקור, מי שרוצה דוקא מהמקור- בספוילר. שימו לב כי מי שמוריד את התיקייה שלי חייב לעבוד דוקא עם הגרסאות שציינתי למעלה, מי שמוריד גירסה אחרת צריך לעשות מה שבספוילר.

מי שרוצה דוקא מהמקור יש להוריד את הקוד מדף הגיטהאב הרשמי, או מקישור ישיר זה, ויחלץ את הקבצים כנ"ל. עכשיו יש להעתיק את הקובץ בשם package.json מנתיב זה

C:\Users\Public\NodeBB\install

לנתיב זה

C:\Users\Public\NodeBB

(דהיינו להעתיק אותו לתיקייה הראשית של הקוד).

עכשיו יש לוודא שמותקן לכם GIT במחשב, אם לא יש להתקינו, ניתן גם להוריד מהאתר הרשמי.
אחר סיום ההתקנה יש לגשת לתיקיית NodeBB במחשב, לפתוח משם את Git Bash, בדרך כלל מופיע בלחיצה ימנית בתיקייה >> הצג אפשרויות הוספות >> פתח כאן Git Bash, אם לא יש לפתוח את Git Bash מהקיצור בשולחן העבודה או מכל מקום אחר ולהכניס שם פקודה זו:

cd C:\Users\Public\NodeBB

אחרי שה Git Bash פתוח בתיקייה הרצויה, יש להכניס פקודה זו (דורש אינטרנט):

npm install --production

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

git clone -b v4.2.0 https://github.com/NodeBB/NodeBB.git

ואח"כ לחזור על הפעולות מלמעלה)

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

כעת יש להגדיר את הפורום, שזה אומר להגדיר איפה הקוד ישמור את הנתונים ועל איזה שרת הוא יישאר, וכן הגדרת המשתמש המנהל, לצורך זה יש להוריד ולהפעיל סקריפט זה, פירוט על פעולת הסקריפט בספויילר.

הסקריפט פותח את PowerShell ומכניס את הפקודות הבאות:

cd C:\Users\Public\NodeBB
./nodebb setup

ניתן גם לעשות כן בGIT, פחות נוחה כיון שא"א להדביק בה ע"י ctrl+v

בשורת הפקודה הרגילה יש פקודה אחרת שGPT מאן בו, לך תתווכח...

כעת יתחילו לרוץ המון שורות כשמידי פעם הוא ייעצר בשביל להכניס בו הגדרות מסויימות, בשביל התקנה אופליין אם עשיתם עד עכשיו ע"פ ההוראות כל ההגדרות אמורות להיות כברירת המחדל שלהם ואין עליכם אלא ללחוץ על ENTER כל פעם שיתבקש (בשורה של URL אם אין ברירת מחדל יש להכניס כתובת זו: http://localhost:4567), עד שהוא יגיע להגדרת המנהל ויציג שורות אלו:
Administrator username: שזה אומר שם משתמש של המנהל, עליכם להכניס את שם המשתמש שאתם מעוניינים, ניתן גם להכניס בעברית ולא להיבהל מהאותיות ההפוכות.
Email: יש להכניס את כתובת המייל הרצויה.
Password: יש להקליד את הסיסמה הרצויה, היא לא תופיע על המסך אבל היא קיימת, ואז יהיה שורה נוספת לאימות הסיסמה.
כעת יש להמתין לגמר ההרצה.
אם הפקודה גומרת לרוץ ולא מופיע השורות הנ"ל יש לגשת בדפדפן לכתובת http://localhost:4567/ ולהמשיך עפ"י ההוראות.
אחרי גמר ההרצה בעצם הפורום קיים ומוגדר ואין לנו אלא להיכנס אליו.
להפעלת הפורום יש להוריד ולהפעיל סקריפט זה, פירוט בספוילר.

הסקריפט פותח את PowerShell ומכניס את הפקודות הבאות:

cd C:\Users\Public\NodeBB
./nodebb start

ניתן גם לעשות כן בGIT, פחות נוחה כיון שא"א להדביק בה ע"י ctrl+v

בשורת הפקודה הרגילה יש פקודה אחרת שGPT מאן בו, לך תתווכח...

שימו לב, החלון שייפתח חייב להיות פתוח כל הזמן שרוצים להשתמש בפורום, כרגע לא מצאתי דרך להתגבר על זה. וכן לאחר סגירת החלון והפורום לגישה לפורום מחדש יש להפעיל שוב.

לאחר מכן, גשו לדפדפן ופתחו כתובת זו: http://localhost:4567 והנה הפורום לפניכם (אם לא עובד יש לרענן עד לפתיחה), כנסו עם המשתמש המנהל שלכם וגלו את אורות הפורום שלכם.

שימו לב כי כברירת מחדל הפורום באנגלית, לשינוי השפה יש לגשת לכתובת זו ולשנות את השפה (משנה רק את הפורום ולא את הקטגוריות והפוסטים הקיימים).

בהצלחה!

נ.ב. המדריך הינו נסיוני ואשמח לכל הערה, הארה ותגובה בפרטי / בנושא התגובות.
אשמח גם לשמוע ממי שעובד לו.

המקום הראשון שמדריך זה פורסם הינו בפורום אנונימי אופליין בשם 'פלמנמוני'...