لوحة إعدادات الصفحة (Page Settings Panel)

إعدادات الصفحة (Page Settings) هي لوحة في المحرر حيث يمكن للمستخدمين تغيير حقول المنشور/الصفحة مثل: العنوان، والمقتطف (إذا كان نوع المنشور يدعم المقتطفات)، والصورة البارزة، وحالة المنشور، وما إلى ذلك.

تعتمد إعدادات الصفحة على المنشورات/الصفحات، مما يعني أن كل منشور أو صفحة على الموقع لها إعداداتها الفريدة المحفوظة في جدول wp_posts في قاعدة البيانات.

التركيب والوظيفة (Structure and Functionality)

تحتوي اللوحة على ثلاثة تبويبات:

• الإعدادات (Settings) - إدارة إعدادات الصفحة العامة.
• الأنماط (Style) - إدارة تنسيق الصفحة.
• المتقدمة (Advanced) - إدارة إعدادات الصفحة الأخرى.

لوحة الإعدادات هي ما يقابل شاشة تحرير المنشور/الصفحة في ووردبريس ضمن إيلمنتور. وهنا يمكنك تعيين عنوان الصفحة، المقتطف، الصورة البارزة، إلخ.

تُستخدم إعدادات الأنمط لإضافة تنسيق جديد على مستوى الصفحة، على عكس إعدادات الموقع حيث تتحكم في الأنماط على مستوى الموقع بأكمله. على سبيل المثال، يمكن للمستخدمين تغيير لون/صورة خلفية الصفحة، متجاوزين بذلك نمط خلفية الموقع.

في التبويب المتقدم، يمكن للمستخدمين إضافة أكواد CSS مخصصة يتم تحميلها فقط على هذه الصفحة.

استرجاع البيانات المحفوظة (Retrieving Saved Data)

البيانات الموجودة في تبويب الإعدادات هي بيانات صفحة/منشور ووردبريس العادية التي يمكن استرجاعها باستخدام وظائف القالب العادية.

// استرجاع بيانات الصفحة
$page_id = get_the_ID();
$page_title = get_the_title();
$page_excerpt = get_the_excerpt();
$page_author = get_the_author();
$page_permalink = get_permalink();
$page_thumbnail = get_the_post_thumbnail();

يتم حفظ البيانات الموجودة في تبويب الأنماط في post meta الخاصة بالصفحة. تحتوي هذه البيانات الوصفية (post meta) على معظم الإعدادات المتعلقة بإعدادات المستند (باستثناء بعض الإعدادات التي تتطلب معاملة مختلفة).

// استرجاع مدير إعدادات الصفحة
$page_settings_manager = \Elementor\Core\Settings\Manager::get_settings_managers( 'page' );

// استرجاع نموذج الإعدادات للصفحة الحالية
$page_settings_model = $page_settings_manager->get_model( $page_id );

// استرجاع البيانات من عنصر تحكم مخصص
$test_color = $page_settings_model->get_settings( 'test_color' );

echo $test_color; // الناتج المحتمل: '#9b0a46'

إضافة إعدادات جديدة (Adding New Settings)

يمكن للمطورين إضافة عناصر تحكم جديدة إلى هذه اللوحة. يتم ذلك عن طريق حقن عناصر التحكم في إعدادات الصفحة.

فيما يلي مثال لكيفية إضافة عنصر تحكم بالألوان إلى تبويب الأنماط:

/**
 * Register additional document controls.
 *
 * @param \Elementor\Core\DocumentTypes\PageBase $document The PageBase document instance.
 */
function register_document_controls( $document ) {
 
    if ( ! $document instanceof \Elementor\Core\DocumentTypes\PageBase || ! $document::get_property( 'has_elements' ) ) {
        return;
    }
 
    $document->start_controls_section        'test_section',
        [
            'label' => esc_html__( 'Test Section', 'textdomain' ),
            'tab' => \Elementor\Controls_Manager::TAB_STYLE,
        ]
    );
 
    $document->add_control(
        'test_color',
        [
            'label' => esc_html__( 'Test Color', 'textdomain' ),
            'type' => \Elementor\Controls_Manager::COLOR,
            'selectors' => [
                '{{WRAPPER}}' => 'background-color: {{VALUE}}',
            ],
        ]
    );
 
    $document->end_controls_section();
}
add_action( 'elementor/documents/register_controls', 'register_document_controls' );

في نطاق إعدادات الصفحة، يمثل العنصر النائب {{WRAPPER}} فئة فريدة لعنصر <body>.