רישום וידג'טים מותאמים אישית של תוסף בניית עמודים לתרגום

כדי לרשום וידג'טים מותאמים אישית של תוסף בניית עמודים לתרגום, עליך להשתמש בקובץ wpml-config.xml. עקבו אחר מדריך זה כדי ללמוד כיצד להשתמש בו.

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

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

תוספי בניית עמודים כמו Elementor, Beaver Builder, SiteOrigin ו־Cornerstone מגיעים עם חבילה של וידג'טים משלהם. וידג'טים אלה המוגדרים כברירת מחדל עובדים בצורה חלקה עם WPML.

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

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

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

מתי עלי לרשום וידג'טים מותאמים אישית לתרגום?

עליך לרשום את הווידג'ט המותאם אישית שלך לתרגום:

• אם זהו וידג'ט שלא סופק במקור על ידי תוסף בניית עמודים
• אם יצרת והוספת אותו דרך תוסף או תבנית אחרים
• אם הוא פותח עבור אתרי ה־WordPress שלך או עבור תוסף בניית עמודים ספציפי על ידי הצוות שלך או צדדים שלישיים

בעבר, הדרך הנפוצה ביותר לרשום וידג'טים מותאמים אישית לתרגום הייתה באמצעות קוד PHP מותאם אישית. כעת, תוכל לרשום בקלות את הווידג'ט לתרגום באמצעות wpml-config.xml, קובץ ההגדרות של WPML.

כיצד לרשום וידג'טים מותאמים אישית של Elementor ובלוקים של Gutenberg לתרגום באמצעות התוסף Multilingual Tools

התוסף שלנו Multilingual Tools כולל WPML – Config Generator עבור בלוקים של Elementor ו־Gutenberg. תכונה זו מאפשרת לך להוסיף לעמוד כל וידג'ט מותאם אישית של Elementor או בלוק של Gutenberg שברצונך לרשום לתרגום. לאחר מכן, היא מייצרת אוטומטית את הגרסה הראשונה של קוד ה־XML שאתה צריך.

למד כיצד לרשום וידג'טים מותאמים אישית של Elementor לתרגום וכיצד להפוך בלוקים של Gutenberg לניתנים לתרגום.

כיצד למצוא את פרטי הרישום של וידג'ט

כדי שתוכל לרשום וידג'ט מותאם אישית בתוך הקובץ wpml-config.xml , עליך למצוא תחילה מידע בסיסי אודותיו.

תוכל לקבל מידע זה בקלות באמצעות תוסף כמו JSM Show Post Metadata. תוסף זה מציג מטא-נתונים של פוסטים ואת הערכים הלא מומרים (unserialized) שלהם בתיבת מטא בתחתית עמודי עריכת פוסטים.

לחלופין, תוכלו לבצע את השלבים הבאים כדי לקבל מידע זה:

1. עבור אל העמוד WPML → הגדרות, גלול למקטע תרגום שדות מותאמים אישית ולחץ על הקישור הצג שדה מערכת .
2. הגדר את השדה המותאם אישית _elementor_data לתרגום.
3. צור עמוד חדש והוסף רק את הווידג'ט של Elementor שברצונך לרשום. שמור את העמוד.
4. עבור אל WPML → הגדרות ובמקטע עורך תרגום הפעל באופן זמני את האפשרות עורך תרגום קלאסי.
5. נסה לתרגם את העמוד שיצרת בשלב 3 באמצעות עורך תרגום קלאסי ותבחין במערך מומר (serialized array), כך:

6. העתק את התוכן של המערך המומר.
7. השתמש בכלי ה־unserialize המועדף עליך כדי לראות טוב יותר כיצד הווידג'ט פולט את התוכן שלו. במקרה שלנו, השתמשנו ב־Unserialize site.

להלן ההסבר על תוכן המערך שתראה:

• [widgetType] מכיל את השם שהוזן בתכונה name של תגית הווידג'ט.
• השדות בפועל יהיו בתוך Array (מערך) ותוכל למצוא אותם על ידי חיפוש של [0] שיביא את התוכן של האיבר הראשון במערך.
• הערך של field יהיה השם בתוך הסוגריים שיכיל את שם השדה. לדוגמה: [title] => this is a field title. במקרה זה, "title" הוא הטקסט שאתה צריך.
• "Items of" יקבל את הערך שלו מהרכיב שיוצר את המערך. לדוגמה: [contents]=> array. במקרה זה, "contents" הוא הטקסט שאתה צריך.

ברגע שיש לך את המידע הזה, תוכל להמשיך לרישום בפועל של הווידג'ט לתרגום.

רישום וידג'טים פשוטים

הסרטון הבא מדריך אותך דרך דוגמה של רישום וידג'ט פשוט של Elementor:

הדוגמה הבאה ממחישה כיצד לרשום וידג'ט פשוט. וידג'ט פשוט כאן משמעותו שלווידג'ט אין שדות חוזרים (repeater).

<wpml-config>
	<elementor-widgets>
		<widget name="heading">
			<conditions>
				<condition key="widgetType">heading</condition>
			</conditions>
			<fields>
				<field type="Heading" editor_type="LINE">title</field>
				<field type="Heading: Link URL" editor_type="LINK">link>url</field>
			</fields>
		</widget>
	</elementor-widgets>
</wpml-config>

נעבור על המבנה של הדוגמה שניתנה:

1. התחל עם התגית <elementor-widgets>. תגית זו אומרת ל־WPML אילו וידג'טים של תוסף בניית עמודים אתה הולך לרשום. זה יכול להיות אחד מאלה:
   • <elementor-widgets>: יש להשתמש בזה אם אתה משתמש ב־Elementor, ב־Elementor PRO או בכל תוסף נלווה אחר של Elementor.
   • <beaver-builder-widgets>: יש להשתמש בזה אם אתה משתמש ב־Beaver Builder Lite, ב־Beaver Builder פרימיום או בכל תוסף נלווה אחר של Beaver Builder.
   • <siteorigin-widgets>: יש להשתמש בזה אם אתה משתמש בתוסף בניית העמודים SiteOrigin.
   • <cornerstone-widgets>: ויש להשתמש בזה עבור תוסף בניית העמודים Cornerstone שמגיע עם התבנית X או התבנית PRO.
2. הוסף את הווידג'טים שלך:
   • <widget name="widget_name"> כאשר widget_name הוא השם שמשמש לרישום הווידג'ט בתוסף בניית העמודים.
   • <conditions> (אופציונלי): תחת conditions, אתה מוסיף תנאי עם מפתח שווה לשם הווידג'ט. ניתן להשתמש בזה כאשר שם הווידג'ט שונה ממפתח הווידג'ט בנתונים, אך בדרך כלל זה לא נחוץ.

3. הוסף את השדות של הווידג'טים, ועטוף אותם בתגית <fields>:
   • field: המזהה (ID) של השדה. זהו אותו מזהה שמשמש בעת הוספת פקד דרך הפונקציה Control_stack::add_control.
   • type (אופציונלי): סוג השדה. זהו הטקסט המוצג בתוך עורך תרגום מתקדם או עורך תרגום קלאסי של WPML כדי לעזור למתרגם לדעת איזה שדה מתורגם.
   • editor_type (אופציונלי): זהו סוג שדה הטקסט המשמש בתוך עורך תרגום קלאסי של WPML. ערכים חוקיים הם LINE, AREA, LINK, ו־VISUAL. ברירת המחדל היא LINE אם חסר.
   • key_of (אופציונלי): משמש רק לתגיות <field> שיש להן מערך בתוך תגית <fields-in-item>.

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

רישום שדות עם מזהי פוסטים או טקסונומיות

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

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

• type="post-ids" – עבור שדות המכילים מזהי פוסטים
• type="term-ids" – עבור שדות המכילים מזהי טקסונומיה/מונח

כאשר אתה משתמש בערכי types אלה:

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

דוגמה:

<wpml-config>
    <elementor-widgets>
        <widget name="the-widget-name">
            <fields>
                <field type="post-ids" sub-type="attachment">image_id</field>
                <field type="post-ids" sub-type="post">selected_posts</field>
                <field type="term-ids" sub-type="category">category_filter</field>
            </fields>
        </widget>
    </elementor-widgets>
</wpml-config>

בדוגמה זו, התכונה האופציונלית sub-type מציינת את סוג הפוסט או הטקסונומיה המדויקים המומרים:

• עבור type="post-ids": השתמש ב־sub-type="attachment", sub-type="post", sub-type="page", או במזהה הכתובת (slug) של סוג התוכן המותאם אישית שלך
• עבור type="term-ids": השתמש ב־sub-type="category", sub-type="post_tag", או במזהה הכתובת (slug) של הטקסונומיה המותאמת אישית שלך

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

לדוגמאות נוספות, ראה את קובץ ההגדרות של Elementor וחפש post-ids.

רישום וידג'טים עם שדות חוזרים

הסרטון הבא מדריך אותך דרך דוגמה של רישום וידג'ט מתקדם של Elementor עם שדות חוזרים:

עבור הווידג'טים שיש להם שדות חוזרים, עליך לעטוף את השדות בתגית <fields-in-item items_of="tabs"> (כאשר tabs הוא שם הווידג'ט עם השדות החוזרים). עיין בדוגמה זו:

<widget name="accordion">
	<fields-in-item items_of="tabs">
		<field type="Accordion: Title" editor_type="LINE">tab_title</field>
		<field type="Accordion: Content" editor_type="VISUAL">tab_content</field>
	</fields-in-item>
</widget>

במקרים מסוימים, לווידג'ט יכולים להיות מספר שדות חוזרים. קח לדוגמה את מבנה הנתונים הבא מווידג'ט Table של Ultimate Addons for Elementor:

כדי לרשום וידג'ט זה, אנא עיין בדוגמה הבאה:

<widget name="uael-table">
	<fields-in-item items_of="table_content">
		<field type="The Cell text" editor_type="LINE">cell_text</field>
	</fields-in-item>
	<fields-in-item items_of="table_headings">
		<field type="The Heading text" editor_type="LINE">heading_text</field>
	</fields-in-item>
</widget>

רישום וידג'טים עם שדות פשוטים וחוזרים גם יחד

שים לב, וידג'טים יכולים להכיל את שני הסוגים: fields ו־fields-in-item. עיין בדוגמה זו עבור וידג'ט שמשתמש בשניהם:

<widget name="price-table">
	<fields>
		<field type="Price Table: Heading" editor_type="LINE">heading</field>
		<!-- ... -->
	</fields>
	<fields-in-item items_of="features_list">
		<field type="Price table: text" editor_type="LINE">item_text</field>
	</fields-in-item>
</widget>

קיבוץ שדות לארגון טוב יותר

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

<widget name="hotspot">
    <fields-in-item items_of="hotspot">
        <field type="Hotspot: Label">hotspot_label</field>
        <field type="Hotspot: URL" key_of="hotspot_link">url</field>
        <field type="Hotspot: Content" editor_type="VISUAL">hotspot_tooltip_content</field>
    </fields-in-item>
</widget>

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

רישום סוגים אחרים של תוכן תוסף בניית עמודים

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

משאבים נוספים

כדי ללמוד עוד על הקובץ wpml-config.xml, בקר במדריך קובצי הגדרות שפה.

להתאמה אישית של רכיבים אחרים באמצעות הקובץ wpml-config.xml, בקר במדריכים הנוספים שלנו:

• רישום תוכן של תוסף בניית עמודים לתרגום
• תרגום שורטקודים מותאמים אישית עם WPML
• הגדרת אפשרויות תרגום עבור שדות מותאמים אישית באמצעות קובץ הגדרות של WPML
• רישום מונחים, סוגי תוכן וטקסונומיות מותאמים אישית כניתנים לתרגום
• הפיכת בלוקים מותאמים אישית של Gutenberg לניתנים לתרגום
• תרגום טקסטים שתבניות ותוספים שומרים ב־wp_options
• התאמה אישית של בורר שפות של WPML באמצעות קובץ הגדרות של WPML