מדריך למתחילים כדי WordPress Plugin פיתוח

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

אנחנו הולכים על כמה דרכים כדי להתחיל בפיתוח תוספות עבור וורדפרס. השלבים פשוטים למדי ואינם דורשים מסירות גדולה ללמוד. ידע בסיסי של PHP יהיה שימושי גם עם הבנה בסיסית של מבנה קובץ וורדפרס וחלונית המינהל.

במדריך קצר זה נלך על הצעדים הבסיסיים הדרושים ליצירת WordPress פשוט plug-in. הפונקציונליות תשמש ליצירת קטעים דינמיים בהתבסס על המספר שחלף לשיחת הפונקציה שלנו. יהיה עליך להעלות את קובץ הפלאגין ולהפעיל אותו מחלונית 'מנהל המערכת', ולאחר מכן לבצע מעקב על ידי קריאה לפונקציה שלנו מכל הדפים שבהם אנו רוצים שהקטע יופיע. קישורים אל קוד המקור התוספת הושלמה כבר מאוחר יותר במאמר זה :)

למה לפתח עבור וורדפרס?

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

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

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

1. מבנה תיקיות WP

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

עבור קטן plug-ins אשר רק דורשים קובץ. Php יחיד יש לך את האפשרות למקם את זה ישירות לתוך plug-ins / directory. עם זאת, כאשר אתה מתחיל לפתח יישומים מורכבים יותר זה הרבה יותר שימושי כדי ליצור ספרייה משנה בשם אחרי התוספת שלך. בפנים אתה יכול הבית JavaScript, CSS ו- HTML כולל יחד עם פונקציות PHP שלך.

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

2. החל את קובץ PHP

בעת יצירת תוסף חדש תצטרך להתחיל עם קובץ PHP פשוט. זה יכול להיות שם משהו אבל צריך בדרך כלל לשקף את השם הרשמי של התוספת. כך למשל יצרתי את קוד הבסיס שלנו יש שם הקובץ שלי hongkiat-excerpt.phps.

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

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

3. וורדפרס שמות המוסכמות ושיטות עבודה מומלצות

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

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

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

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

4. צלילה לתוך מסננים ופעולות

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

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

הבנת add_filter ()

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

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

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

add_filter ('wp_title', 'hongkiat_func');

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

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

הבנת add_action ()

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

• publish_post - שנקרא כאשר פוסט פורסם או כאשר המצב השתנה “יצא לאור”
• שמור - שנקרא כאשר פוסט / דף נוצר מראש או מעודכן
• wp_head - שנקרא כאשר התבנית נטענת ומפעילה את wp_head () פונקציה
• loop_end - שנקרא מיד לאחר ההודעה הסופית עובדה באמצעות לולאה וורדפרס
• מעקב אחר - שנקרא בכל פעם trackback חדש מתווסף להודעה

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

add_action ('save_post', 'Notify');

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

גימור לוגיקה Plugin שלנו

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

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

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

מגבלת = $) array_pop ($ content); $ content = implode ("", $ content). '...';  אחר $ content = implode ("", $ content);  $ content = preg_replace ('/\[.+\]/', '$ content') $ content = apply_filters ('the_content', $ content); return $ content;?> 

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

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

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

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

התקנה והפעלת הפלאגין

יצרתי קובץ לדוגמה עבור הפלאגין להדגמה אם אתה רוצה לדלג על קידוד קשה. כל שעליך לעשות הוא להוריד את הקובץ (שנה את שמו ל- .php) או להעתיק / להדביק את הקוד למסמך PHP חדש ולהעלות אותו / wp-content / plugins ספרייה.

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

קובץ זה מכיל את כל התבניות HTML / CSS עבור דף המאמר הבסיסי שלך. גלול מטה עד שתמצא התוכן() ולהחליף את הקוד לדוגמה לעיל. זה יגביל את כל דפי המאמר שלך 55 תווים לא משנה מה להציג משמש. אתה יכול גם להוסיף בפונקציה זו דפים דומים בספריית התבניות שלך כגון search.php או archive.php.

סיכום

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

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