תרומה לקהילת Jetpack

"רוצה לתרום ל- Jetpack?

הידעת שיש לך את הכוח לתרום לשיפור החסינות ובטיחות השימוש ב- Jetpack? אם אהבת את Jetpack, אנו מזמינים אותך לתרום את חלקך ולעזור לנו להפוך אותו לאפילו עוד יותר מגניב!

(אם טרם ניסית את Jetpack, חבל על הזמן, הורד אותו עכשיו!)

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

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

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

תורמים למען כולם!

טילים בחצר האחורית: למשתמשים חדשים ב- Jetpack

אם רק התחלת ללמוד על Jetpack- ברוך בואך!

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

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

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

טיסה למרחקים: למתכנתים ברמה ממוצעת

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

אם בכוונתך למסור דוחות, מומלץ להכיר גם את GitHub. מרגע שהבנת איך עובדת מערכת הדיווח שלנו, באפשרותך לעיין בקוד ולהתכונן לשלב הבא- הגשת מקטעי קוד משלך!

מסעות גלקטיים: למתכנתים ברמה מתקדמת

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

הברגים והאומים של תרומה לקהילת Jetpack

הצטרפות לקבוצת הבטא

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

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

בדיקת קוד המקור

מרבית פרוייקטי התכנה, ובתוכם WordPress, משתמשים במערכת לשליטה בגרסא, כך שניתן לעקוב אחר שינויים בקוד המקור. Jetpack זמין ב- GitHub. להלן מידע בסיסי אודות הורדת Jetpack באמצעות Git:

(אם טרם יצא לך להכיר את Git ואת GitHub, מדריכי הוידאו של GitHub  הם מקום נהדר להתחיל ממנו).

התקנת Git

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

יצירת חשבון GitHub ומפתחות SSH

הקוד של Jetpack מאוחסן באתר GitHub.com, שם ניתן לצפות בו ואף להוריד אותו מבלי ליצור חשבון. יחד עם זאת, אם בכוונתך לתרום על ידי דיווח באגים ושליחת קודים, יצירת חשבון Git היא הכרחית.

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

ניווט במאגר ה- Git של Jetpack

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

מאגר ה- Git  של Jetpack, אשר זמין כאן, מכיל ארבעה חלקים עיקריים:

• Mater: קוד הפיתוח העדכני ביותר.
• Releases: קודים שבאמצעותם אפשר לראות באיזו גרסת Jetpack מדובר (לדוגמא: 2.3.1). לכל גרסא פומבית של Jetpack יש תג משלה.
• Branches: גרסאות Jetpack קודמות. לעיתים, בגרסאות בהן נוצרו שינויים משמעותיים, אנו שומרים את הגרסה הקודמת בתוספת תיקוני באגים (חלק זה מוגבל בדרך כלל  לבאגים ובעיות אבטחה משמעותיות).
• Issues: באגים, בקשות לתכונות חדשות, הערות, הצעות ומקטעים- כולם נמצאים כאן!

בדיקת הקוד

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

1. יש לנווט אל Jetpack's GitHub page ולהקליק על הכפתור "fork". פעולה זו תעתיק את גרסת הפיתוח העדכנית של Jetpack אל חשבון ה- GitHub שלך.
2. עליך לפתוח את המסוף במחשב שלך ולנווט אל הספרייה שבה ברצונך למקם את Jetpack.
3. כעת יש להוציא לפועל את פקודת השיעתוק, לצורך העניין, כדי לבדוק את העתק המאגר שיצרת:   git clone git@github.com:YOUR_GITHUB_USERNAME/jetpack.git jetpack
4. לאחר מכן, יש לנווט אל ספריית cd jetpack.
5. יש להוסיף את מאגר Jetpack המקורי בתור קובץ מרוחק חדש. פעולה זו תאפשר לך למשוך שינויים שעשינו במאגר המקורי ובכך לשמור על עדכניות ההעתק שברשותך.

git remote add upstream git@github.com:Automattic/jetpack.git

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

git fetch upstream

git checkout master

git merge upstream/master

איך ליצור אחלה דוח באגים

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

שלוש דרכים להפוך לכוכב ב- GitHub

1. לוודא שאכן מדובר בבאג.

לפני שדיווחת על באג, חשוב לוודא שלא מדובר בבעיות תאימות או תקלות חיבור לרשת, ושגרסאות ה- WordPress וה-Jetpack שלך עדכניות. כדי לבדוק זאת, מומלץ לכבות את כל התוספים האחרים ולהחליף לערכת העיצוב של ברירת המחדל- "TwentyThirteen" או "TwentyFourteen". אם הבעיה ממשיכה, ייתכן מאוד שגילית באג.

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

2. לבדוק האם דווח כבר על הבעיה.

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

• בדיקה בעמוד "בעיות ידועות".
• בדיקה ברשימת הבעיות הפתוחות הנוכחיות.
• סיור בפורום התמיכה של Jetpack.

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

3. להגיש דוח מדויק ומפורט אודות הבאג.

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

הנה דוגמא למראהו של סיכום יעיל:

סיכום הבעיה: ווידג'ט התמונות של Jetpack לא מוכן להראות תמונה מסוימת

הצעדים שיש לקחת:

1. הפעלת מודול הווידג'טים של סרגלי הצד הנוספים.
2. הכללת ווידג'ט התמונות של Jetpack בתוך סרגל הצד, ומילוי כל השדות, כולל ה- URL של התמונה.
3. שמירת הווידג'ט וצפייה באתר.

התוצאה הצפויה: סרגל הצד יראה את התמונה הנבחרת

התוצאה בפועל: מופיעה הודעת שגיאה שאומרת: "התמונה לא נמצאה".

קישור דוגמא לתופעה זו: http://example.com/image-widget

צילומי מסך: כאן יהיה מקום טוב לצרף תמונות מסך של הודעת השגיאה

בדיקת דפדפנים רחבה, הידועה גם בשמה הנפוץ "אסור לשכוח את אקספלורר 8"

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

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

תרומות ותגובות לבעיות קיימות

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

כדי לבצע מעקב שכזה, צריך להתחבר ל- GitHub, למצוא את הבעיה שמעניינת אותך, לגלול למטה ולהקליק על הכפתור Subscribe.

אם יש בידייך מידע נוסף אודות בעיה קיימת, תמיד נשמח תקבל ממך תגובה!

חיבור בין כל הדברים: יצירה והגשה של מקטעי קוד

חיסול באגים

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

git branch branch-name

git checkout branch-name

כעת באפשרותך לערוך ולהגיש את השינויים לכל אורך התהליך.

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

git status

• ניתן לראות את השינויים שביצעת בפורמט של שורה אחר שורה, על ידי שימוש בפקודת ה- diff לייצוא של diff מאוחד לכל השינויים שביצעת בקוד המקור.

git diff

• כדי לראות את ההבדלים בקובץ יחיד, ניתן להשתמש שוב בפקודת ה-diff, או לכלול מספר נתיבי קובץ כדי להראות את ההבדלים בין סדר��ת של דפים.

git diff path/to/file

ייצוא מקטעי קוד

על מנת לשתף את השינויים שביצעת, יש להחיל אותם על המאגר שלך ב- GitHub, ולהגיש בקשת משיכה.

1. הצעד הראשון יהיה להחיל אותם על המאגר המקומי שלך, על ידי הוספת הקבצים ששינית לאזור ההיערכות-  git add .
2. כעת עלייך להגיש את השינויים שלך-  git commit.
3. מומלץ שהשורה הראשונה של הודעת ההגשה תהיה תקציר של כל השינויים שלך. את הפרטים עדיף להוסיף בהמשך ההודעה.
4. כעת משהגשת את השינויים שלך, הם מוכנים לעבור אל המזלג שלך ב- GitHub, באופן הבא:  git push origin branch-name
5. הצעד האחרון הוא ליצור בקשת משיכה וליידע אותנו על השינויים שלך. GitHub יתריע אותך על יצירת הבקשה בעת הגישה למזלג שלך.

ליצירת בקשת משיכה יש ללחוץ על "השווה ומשוך בקשות"

שיטות פיתוח מומלצות לכולם!

לשיטות הכי טובות יש לעיין במידע הזמין בקודקס של WordPress.org, שם נמצא מידע נוסף אודות קודים סטנדרטיים של PHP, HTML, CSS ,ו-JavaScript.