SEO (רפרנס המחלקה)

המחלקה SEO (system/collections/SEO.php, api/core/collections/SEO.php בריפו) היא אוסף סטטי ששומר את תגיות ה-<head> של העמוד הנוכחי: כותרת, תיאור, מילות מפתח ו-Open Graph. הקונטרולר ממלא אותה לפני הרינדור, ו-PAGE::output() מדפיס אותה דרך SEO::tags_summary(). הדף הזה הוא הרפרנס של המחלקה; מה מפתח אתר צריך לעשות סביבה (canonical, robots, sitemaps, 404, JSON-LD) מופיע ב-SEO למפתחי אתר, והתגיות מנקודת מבט של העמוד ב-תגיות SEO ו-Schema.

מחזור החיים בבקשה אחת#

1. PAGE::load() קוראת ל-SEO::init() מיד אחרי PARAMS::init(): כל השדות מתאפסים למחרוזת ריקה.
2. הקונטרולר קורא ל-SEO::set() / SEO::set_var() ול-SEO::set_key().
3. PAGE::output() (רק בעמוד מלא, כלומר לא pmode=empg/inner) קוראת ל-SEO::tags_summary() בתחילת ה-<head> ומדפיסה את התוצאה, ובעמוד לקוח גם SEO::get_schema("WebPage").

משתנים סטטיים#

SEO::init()#

static function init()

מאפסת כל ערך ב-SEO::$fields ל-"" (גם מפתחות שנוספו בזמן ריצה). נקראת על ידי PAGE::load(); אין סיבה לקרוא לה מקוד אתר.

SEO::set_key()#

static function set_key($key)

מציבה את SEO::$page_key. המפתח הוא כינוי לרשומה ב-CRM_seo_center עם is_by_url = 0 (למשל home או news_42), לפי מה שנכנס בשדה FormInput_SEO::$key בפאנל. אין מחזיר.

SEO::set(), SEO::set_var()#

static function set($fields, $value)       // כינוי: return self::set_var($fields, $value)
static function set_var($field, $value)    // אין ערך החזרה

שני הפרמטרים נקראים $fields / $field אבל מדובר בשדה אחד. הערך מועבר דרך המתג הבא (המפתחות הם שמות "קצרים", וחלקם כותבים לשני שדות):

// application/controllers/news.php
SEO::set("title", $row["title"]);
SEO::set("description", $row["summary"]);
SEO::set("image", (int)$row["image_id"]);              // מספר: נהפך לתמונה 1200x627
SEO::set("url", CONFIG::$site_url . "news/" . (int)$row["id"]);
SEO::set("og_type", "article");                        // מודפס כ-og:type
SEO::set_key("news_" . (int)$row["id"]);               // רשומת seo_center לפי מפתח

SEO::tags_summary()#

static function tags_summary()    // מחזירה string של HTML

נקראת על ידי PAGE בלבד. הסדר:

1. ברירות מחדל מהפלטפורמה. שדה ריק מקבל את seo_title, seo_description או seo_keywords מ-CONFIG::$platform_data. אם אין כותרת, SEO::$title_include_sitename מכובה כדי שהשם לא יודפס פעמיים.
2. חיפוש ב-CRM_seo_center. המפתח הראשון הוא הנתיב: og_url (או REQUEST_URI כשהוא ריק), רק החלק של ה-path, בלי / בהתחלה ובסוף, אחרי urldecode, עם is_by_url = 1. אם לא נמצא וגם SEO::$page_key לא ריק: לפי page_key עם is_by_url = 0.
3. דריסה מהרשומה. כל עמודה לא ריקה ברשומה עוברת set_var ודורסת את מה שהקונטרולר קבע. עמודות מבניות מדולגות (id, page_key, is_by_url, ord, title_include_sitename, platform_id, lang, is_active, date_created, date_updated, created, updated), ו-title_include_sitename נקרא רק כשיש meta_title ברשומה. scripts מוזרק ל-PAGE::add_meta(). og_image/image ברשומה הוא מספר קובץ (> 0) ונפתר ל-STORAGE::get_by_name($val, "wide", 1200, 627).
4. הדפסה. קודם <meta name="twitter:card" content="summary_large_image">, אחריה תגית האימות של Search Console (ראו SeoVerification), ואז כל שדה לא ריק לפי הטבלה:

כל הערכים חוץ מ-<title> עוברים htmlspecialchars.

SEO::get_schema()#

static function get_schema($type)    // "WebPage" | "Organization" | "NewsArticle"

מחזירה מחרוזת <script type="application/ld+json">...</script>. סוג לא מוכר מחזיר תגית עם [].

החלקים הסמוכים#

PAGE::add_meta(), print_meta_tags()#

public static function add_meta($val, $area = "head")
public static function print_meta_tags($area = "")

add_meta מוסיפה מחרוזת HTML גולמית (תגית <meta>, <link>, <script>) לאזור (head כברירת מחדל). print_meta_tags מדפיסה לפי אזור. שימו לב: ערך שמוזרק כך אינו עובר escaping, ולכן כל נתון שמגיע ממשתמש חייב לעבור htmlspecialchars לפני ההזרקה. פרטים ב-PAGE: נכסים, מטא ואירועים.

PAGE::add_meta('<link rel="canonical" href="' . htmlspecialchars(CONFIG::$site_url . "news/" . (int)$row["id"], ENT_QUOTES) . '">');

PAGE::$robots#

מחרוזת, ברירת מחדל "ALL", מודפסת בכל עמוד ב-<meta name="ROBOTS" content="..."> מיד אחרי תגיות head:

PAGE::$robots = "noindex, follow";

SeoVerification::meta_tag()#

public static function meta_tag(): string    // system/libraries/SeoVerification.php

מחזירה <meta name="google-site-verification" content="..."> מהטוקן ששמור בפרמטר של CRM_params, או מחרוזת ריקה כשאין טוקן. tags_summary קוראת לה בתוך try/catch, בכל עמוד ולא רק בדף הבית, ושגיאה בה לא פוגעת בעמוד. הטוקן נקרא ב-SELECT ישיר מהטבלה, לא דרך PARAMS, כך שהוא נכנס לתוקף מיד אחרי שמירה (אבל עמוד שנשמר במטמון לא יציג אותו, ראו מטמון עמודים מלא).

רשומות seo_center#

הטבלה CRM_seo_center נערכת בפאנל /{admin}/seo_center ובשדה FormInput_SEO. עמודות הליבה:

אתר שמקים מסד חדש חייב ליצור אותה (DDL ב-SQL להקמה). ראו גם סכמת הטבלאות.

// הוספת רשומת SEO לדף הבית בלי הפאנל (לא להריץ על אתר חי בלי לבדוק קודם שאין רשומה)
$ins = DB::update("seo_center");
$ins->set_var("page_key", "home");
$ins->set_var("is_by_url", 0);
$ins->set_var("meta_title", "Wizzo - הבית");
$ins->set_var("meta_description", "תיאור קצר לדף הבית");
$ins->insert();

דף NEWPAGE#

הקונטרולר newpage_public (דפי נחיתה מ-NEWPAGE) משתמש ב-SEO::set_var("title", ...) וב-SEO::set_var("description", ...) מנתוני head של השירות. את og:image ואת noindex הוא מוסיף ישירות ב-PAGE::add_meta(), לא דרך SEO::$fields.

ראו גם#

• SEO למפתחי אתר: canonical, robots, 404 מול 503, sitemap, JSON-LD
• תגיות SEO ו-Schema, PAGE: נכסים, מטא ואירועים, PAGE (רפרנס)
• כתובות ידידותיות ו-הפניות 301
• חבילת ה-SEO, IndexNow ואימות