لوحة تفضيلات المستخدم

لوحة تفضيلات المستخدم (User Preferences Panel)

تفضيلات المستخدم (User Preferences) هي لوحة في المحرر حيث يمكن للمستخدم التحكم في مظهر وإحساس المحرر. يمكن للمستخدمين اختيار ما إذا كانوا يريدون عرض سمة فاتحة أو داكنة، أو تعيين عرض اللوحة الافتراضي، أو قراره إظهار/إخفاء أزرار التحرير، وما إلى ذلك.

هذه التفضيلات خاصة بالمستخدم، مما يعني أن المستخدمين المختلفين يمكنهم تعيين تفضيلات مختلفة بأنفسهم. يتم حفظ هذه البيانات في جدول wp_users في قاعدة البيانات.

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

حالياً، تحتوي اللوحة على قسم واحد فقط:

• التفضيلات (Preferences) - إدارة مظهر وإحساس المحرر.

توسيع اللوحة (Extending the Panel)

يمكن للمطورين توسيع لوحة تفضيلات المستخدم عن طريق حقن عناصر تحكم جديدة في اللوحة. تأكد من إضافة عناصر التحكم التي تدير كيفية عرض إضافتك (addon) في المحرر فقط.

إضافة تفضيلات جديدة (Adding New Preferences)

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

في المثال أدناه، سنقوم بإضافة عنصر تحكم جديد:

/**
 * @param \Elementor\Core\Settings\EditorPreferences\Model $preferences The editor preferences model.
 */
function add_preferences_controls( \Elementor\Core\Settings\EditorPreferences\Model $preferences ) {
    $preferences->add_control(
        'something',
        [
            'label' => esc_html__( 'Enable Something', 'textdomain' ),
            'type' => \Elementor\Controls_Manager::SWITCHER,
            'default' => 'yes',
        ]
    );
}
add_action( 'elementor/element/editor-preferences/preferences/before_section_end', 'add_preferences_controls' );

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

يتم حفظ البيانات الموجودة في لوحة التفضيلات في البيانات الوصفية للمستخدم (user's metadata). تحتوي البيانات الوصفية للمستخدم على جميع الإعدادات المتعلقة بتفضيلات المحرر الخاصة به.

فيما يلي مثال لكيفية استرجاع هذه البيانات:

$something = get_user_meta( get_current_user_id(), 'something', true );