README.md

zmanim-node זמנים-נוד

אפליקציית נוד לבדיקת זמני ההלכה + אפשרות הרשמה לקבלת התראות פוש רבע שעה לפני שקיעה לפי ערים בישראל

האפליקציה (רצה על הרוקו Heroku): https://chvsunset.herokuapp.com

API זמנים

האפליקציה כוללת API לקבלת זמני היום לכל עיר בישראל.

יש לגשת ל-URL הזה - https://chvsunset.herokuapp.com/api
עם פרמטר של העיר הרצויה - https://chvsunset.herokuapp.com/api/?city=ירושלים

בתשובה יתקבל JSON עם הנתונים (מה שמקבלים באתר כשעושים בדיקת זמנים - הנץ, קריאת שמע-גר"א, חצות ושקיעה) במבנה הזה:

{
    "cityname": "ירושלים",
    "netz": "05:34:51",
    "gra": "09:08:14",
    "chatzos": "12:41:36",
    "shkia": "19:48:22"
}

דוגמא לשימוש ב-API בג'אווהסקריפט:

async function getzman(city) {
  const response = await fetch('https://chvsunset.herokuapp.com/api/?city=' + city)
  const data = await response.json()
  return data
}

כעת נקרא לפונקציה ככה:

getzman('ירושלים')

לדוגמא אם רוצים לקבל את השקיעה -

let times = await getzman('ירושלים')
console.log(times.shkia)

📦 חבילות עיקריות בשימוש:

• kosher-zmanim
• node-geocoder
• moment
• web-push

אפשר לראות את שלבי ה'פרוייקט' כאן וכאן
(לכניסה לשני הקישורים יש להירשם לפורום תחומים + כניסה לקבוצת 'תיכנות')

אשמח להערות והארות!!

התקנה לוקלית

כדי להפעיל אצלכם במחשב, הורידו את הריפו

git clone https://github.com/chaim-chv/zmanim-node.git && cd zmanim-node

והכניסו את המפתחות המתאימים בקובץ env (צריך להכניס את מפתחות ה-VAPID - מפיקים אותם בצורה פשוטה כמו שמוסבר כאן. חוץ מזה צריך להכניס גם כתובת URI של מסד נתונים MongoDB)

ואז התקנה של החבילות הנצרכות ב-npm:

npm install

ואז

npm start

יפעיל שרת לוקאלי בפורט 5000 אצלכם (או שתגדירו אחרת).

הפעלה בהרוקו

להתקנה מהירה בהרוקו - לחצו על הכפתור והגדירו את המפתחות המתאימים במקומות הנכונים (יש תיאור לכל מפתח):

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

git clone https://github.com/chaim-chv/zmanim-node.git && cd zmanim-node

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

כעת צרו אפליקציה חדשה עם Heroku-CLI:

heroku create <app-name>

ותדחפו אליה את התוכן:

git push heroku master