שדות טופס: FormInput

כל שדה בטופס הוא מחלקה FormInput_<Type> שיודעת להציג את עצמה (get_html) ולהחזיר מה לשמור (get_results). הדף הזה הוא קטלוג קצר: איזה שדה מתאים למה, אילו מאפיינים הוא מקבל ומה נכתב לעמודה. את כל המאפיינים והמתודות תמצאו ב-רפרנס שדות טופס, ואת מחזור הטופס ב-טפסים.

system/ הוא תיקיית הליבה (api/core בריפו). קוד השדות נמצא ב-system/libraries/forms/ (FormInputs.php ועוד קבצים לפי שדה).

מאפיינים משותפים#

כל שדה נבנה עם new FormInput_Type("שם_העמודה") ומקבל:

$title = new FormInput_Text("title");
$title->title = "כותרת";
$title->placeholder = "למשל: חדשות היום";
$title->Must();
$frm->push($title);

טקסט ומספרים#

עורכי תוכן עשיר:

$body = new FormInput_WZ_Editor("body");
$body->title = "תוכן";
$body->height = 500;
$body->table = "content";
$frm->push($body);

בחירה#

// אפשרויות ידניות
$dir = new FormInput_Select("direction");
$dir->title = "כיוון";
$dir->set_var("rtl", "מימין לשמאל");
$dir->set_var("ltr", "משמאל לימין");
$frm->push($dir);

// מטבלה
$cat = new FormInput_SelectDB("cat_id");
$cat->title = "קטגוריה";
$cat->query = DB::query("categories", [], "name");
$cat->queryVal = "name";
$frm->push($cat);

// תגיות עם טבלת קשר
$tags = new FormInput_Tags("tags");
$tags->title = "תגיות";
$tags->query = DB::query("tags");
$tags->rel_table = "articles_tags";
$tags->rel_item_key = "article_id";
$tags->rel_tag_key = "tag_id";
$tags->save_to_db = false;
$tags->requireID = true;   // טבלת הקשר נכתבת אחרי שהמזהה ידוע
$frm->push($tags);

FormInput_Select מצפה למערך $options[מפתח]["title"], ו-set_var עושה את זה בשבילכם. ערכים שנשמרים בפורמט |1||2| נקראים בחזרה עם MISC::bgl_explode.

מתגים וסיסמאות#

קבצים ותמונות#

$logo = new FormInput_drop("logo");
$logo->title = "לוגו";
$logo->dir = "media/buttons";      // תיקייה תחת storage
$frm->push($logo);

בטבלה מציגים תמונה עם "type" => "image" (מזהה storage מומר ל-URL בעצמו). בטופס, הסרת תמונה נשמרת כ-NULL. פרטי STORAGE ב-אחסון.

תאריכים ושעות#

$when = new FormInput_Calendar("publish_at");
$when->title = "מועד פרסום";
$when->withMinutes = true;
$frm->push($when);

SEO#

שימוש מלא ב-SEO למפתחי אתר וב-כתובות ידידותיות.

שדות תצוגה ושדות מורכבים#

FormInput_Label שימושי להפרדה בין חלקי טופס:

$lbl = new FormInput_Label("lbl_login");
$lbl->value = "<b>פרטי התחברות</b>";
$frm->push($lbl);

כתיבת שדה משלכם#

מחלקת שדה מותאמת נכנסת ל-application/admin/includes/ (נטען אוטומטית בכל בקשת אדמין) ויורשת מ-FormInput. שלוש מתודות עיקריות:

class FormInput_Rating extends FormInput
{
    var $max = 5;

    function get_html()
    {
        $v = (int)($_POST[$this->name] ?? $this->value);
        $h = "";
        for ($i = 1; $i <= $this->max; $i++) {
            $h .= "<label><input type='radio' name='" . htmlspecialchars($this->name)
                . "' value='$i' " . ($v == $i ? "checked" : "") . "> $i</label> ";
        }
        return $h;
    }

    function get_results($id)
    {
        $this->db_id = $id;
        if ($this->mcp_skip_absent($id)) return [];
        $v = (int)($_POST[$this->name] ?? 0);
        if ($this->must && !$this->must_allow_ignore && $v == 0) return "ERROR";
        return [$this->name => $v];
    }

    function api_schema()
    {
        return [
            "label" => $this->title,
            "required" => (bool)$this->must,
            "writable" => true,
            "input" => ["value" => ["type" => "number"]],
        ];
    }
}

חוזה get_results($id): החזרת "ERROR" עוצרת את השמירה, מערך [עמודה => ערך] נכתב לשורה (אפשר להחזיר כמה עמודות), ומערך ריק או "" אומר "אין מה לשמור". api_schema מתארת את השדה ל-ממשק ה-AI.

ראו גם#

• טפסים: מחזור הטופס, ולידציה ורב-לשוניות
• רפרנס שדות טופס
• בניית פאנל חדש
• אחסון (Storage)
• AI בטפסים