Joomla! Documentation™

מדריך
איך להגדיר סביבה לוקלית לג'ומלה 4

Joomla! 

4.x

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

מדריך להתחלה מהירה

מה שאתם צרכים לעשות כדי להגדיר את סביבת הפיתוח תלוי במערכת ההפעלה שלכם. אנחנו לא יכולים לכתוב תיעוד עבור כל מערכת הפעלה לכן אנו ממליצים לבצע חיפוש במנוע החיפוש המועדף עלכם ולמצוא את "כיצד לבצע" (HowTo).

הכלים הנדרשים

1. PHP - בדיוק כמו בגרסאות הישנות יש צורך ב-PHP ובנוסף ב-CLI PHP (ממשק שורת הפקודה) בכדי להפעיל את אתר ג'ומלה, (ראה את הגדרת שרת LAMPP לפיתוח PHP
2. Composer - לניהול התלויות PHP של ג'ומלה - לקבלת עזרה בהתקנת ה-Composer, קראו את התיעוד בכתובת https://getcomposer.org/doc/00-intro.md
3. Node.js - להרכבת קבצי JavaScript ו- SASS של ג'ומלה - לעזרה בהתקנת Node.js, פעלו לפי ההנחיות הזמינות בכתובת https://nodejs.org/en/
4. Git - לניהול גרסאות

צעדים להגדרת הסביבה המקומית

1. לשכפל (clone) את המאגר
2. Checkout the branch of the latest release (currently 4.4-dev).
3. להפעיל composer install</ tt> מספריית השורש של הריפוזיטורי (git repo). אתם יכולים להוסיף את הפרמטר של --ignore-platform-reqs אם אינכם צריכים את PHP-LDAP מותקן מקומי ולכן אין צורך בכך.
4. הריצו npm install מספריית השורש של הריפוזיטורי (git repo).

Linux and OSX users can set up the following bash alias by placing the following inside the ~/.bashrc file:

alias jclean="rm -rf administrator/templates/atum/css; \
rm -rf templates/cassiopeia/css; \
rm -rf administrator/templates/system/css; \
rm -rf templates/system/css; \
rm -rf media/; \
rm -rf node_modules/; \
rm -rf libraries/vendor/; \
rm -f administrator/cache/autoload_psr4.php; \
rm -rf installation/template/css"
alias jinstall="jclean; composer install; npm ci"

This will delete all the compiled files in your system and run a fresh install as one command by calling jinstall inside your Joomla install. You can also use the jclean command to swap back to a Joomla 3.x branch

מדריך למתחילים ארוך יותר

ג 'ומלה אינה שונה בהרבה כלי אינטרנט אחרים בימים אלה. יש לה חלק גדול PHP ויש לו יותר ויותר קוד JavaScript. בעוד קוד PHP לא צריך כל כך הרבה הכנה, JavaScript צריך הרבה כלים סביבו. הסיבה העיקרית לכך היא שאף אחד לא כותב קוד בצורה שכל דפדפן מבין, כך שהקוד צריך להיות מתורגם, למשל, ES6 לגירסה תואמת של ה-JavaScript הנתמך בדפדפן. אותו הדבר נכון לגבי CSS, עבור ג 'ומלה אנו משתמשים SASS אשר ממור ל-CSS כך שכל דפדפן יוכל לתרגם את ההגדרות בצורה נכונה. לכן הגדרת סביבת הפתוח קמצת יותר מסובכת אבל לצד זה מקבלים קידוד (פתוח) נוחים יותר. הודות למערכות תצוגה וטעינה אוטומטית בדפדפנים תוכלו לראות את השינויים שלכם בצורה טובה יותרובזמן אמת.

PHP

הפעלת הפקודה composer install</ tt> צריכה להספיק מכוון שתלויות ה-PHP שמורות בקובץ composer.lock. אתם יכולים לבצע זאת כמה פעמים שתרצו, והפעולה תגרום להתקנת החבילות החדשות בלבד על פי השינויים בקובץ composer.lock. אל תפעילו את composer update</ tt>, שכן פעולה זו תעדכן את כל החבילות לגרסאות חדשות יותר ותעדכן את הקובץ composer.lock.

הערה: ייתכן שתצטרכו להפעיל את composer install</ tt> עם האפשרות --ignore-platform-reqs</ tt> כדי להתעלם מדרישות הפלטפורמה המפורטות ב- Composer, כלומר, אם אין לכם תוסף LDAP של PHP מוּתקָן.

סקריפטי Node/npm

Node.js מגיע עם מנהל חבילה המכונה NPM (בדרך כלשהי כמו Composer). ל- NPM יש פקודה run</ tt> והכנו כמה תסריטים כדי להקל עליכם. עליכם להפעיל את הפקודות עבור שורש ההתקנה.

זה יגרום להמרת קבצי JavaScript לפורמט הנכון וליצור קבצים ממוזערים

זה דומה לפקודה build:css</ tt>, אך יציג את השינויים ויבנה באופן אוטומטי קבצים מעודכנים.

פעולה זו תבצע בדיקת תחביר בקובצי JavaScript.

npm הרצת בדיקה

פעולה זאת תפעיל חבילת בדיקות JavaScript אחרת.

This will run a JavaScript testing suite.

Possible Issues

When running composer install you can run into these errors

Problem 1
    - Installation request for joomla/ldap 2.0.0-beta -> satisfiable by joomla/ldap[2.0.0-beta].
    - joomla/ldap 2.0.0-beta requires ext-ldap * -> the requested PHP extension ldap is missing from your system.
Problem 2
    - Installation request for symfony/ldap v5.1.5 -> satisfiable by symfony/ldap[v5.1.5].
    - symfony/ldap v5.1.5 requires ext-ldap * -> the requested PHP extension ldap is missing from your system.

The solution is to run the composer install with the --ignore-platform-reqs option to ignore platform requirements specified in Composer. That is, if you do not have PHP's LDAP extension installed.

composer install --ignore-platform-reqs

If you receive a login error such as shown below, delete the administrator/cache/autoload_psr4.php file.

Login After Install Error