ثبت ویجت‌های سفارشی در داشبورد اصلی CRM

apply_filters( 'la24_widgets', array $widgets );

add_filter( 'la24_widgets', function ( $widgets ) {

    $widgets['900'] = array(
        'name'       => __( 'خلاصه CRM من', 'my-crm-ext' ),
        'class_icon' => 'fa fa-pie-chart',
        'category'   => array( 'reporting' ),
        'callback'   => '\MyPlugin\Widgets\CrmSummaryWidget',
    );

    return $widgets;
} );

function la24_get_widget_categories(); // includes/helpers/la24-core-functions.php

$widgets['900'] = array(
    'name'       => __( 'خلاصه CRM من', 'my-crm-ext' ),
    'class_icon' => 'fa fa-pie-chart',
    'category'   => array( 'reporting' ),
    'callback'   => '\MyPlugin\Widgets\CrmSummaryWidget',
);

// درست
$widgets['900'] = array( ... );
$widgets['901'] = array( ... );

// از این اجتناب کنید — پایین‌تر از بازه رزرو شده برای افزونه‌های سفارشی، ممکن است با یک ویجت هسته تداخل داشته باشد
$widgets['201'] = array( ... );

// از این اجتناب کنید — کلید باید عددی باشد، نه یک رشته با پیشوند
$widgets['my_deals_900'] = array( ... );

<?php

namespace MyPlugin\Widgets;

defined( 'ABSPATH' ) || exit;

use LoyalAxis\classes\services\widgets\Widget;
use LoyalAxis\classes\utilities\Form;

class CrmSummaryWidget extends Widget {

    public function content( $settings ) {
        global $wpdb;

        $total = (int) $wpdb->get_var( "SELECT COUNT(*) FROM {$wpdb->prefix}my_crm_records" );

        echo "<div class='small-box' style='box-shadow: none !important;'>
                <div class='inner'>
                    <h3 style='color: {$settings['text_color_900']};'>
                        <span style=\"font-size: 20px;\">" . esc_html( $total ) . "</span>
                    </h3>
                    <p>" . esc_html__( 'تعداد کل رکوردها', 'my-crm-ext' ) . "</p>
                </div>
              </div>";
    }

    public static function desktop_size() {
        return array(
            'size_x' => 3, 'size_y' => 1,
            'minx'   => 1, 'miny'   => 1,
            'maxx'   => 6, 'maxy'   => 12,
        );
    }

    public static function mobile_size() {
        return array(
            'size_x' => 2, 'size_y' => 1,
            'minx'   => 1, 'miny'   => 1,
            'maxx'   => 2, 'maxy'   => 6,
        );
    }

    public function default_settings(): array {
        return array(
            'head_text_900'  => __( 'خلاصه CRM', 'my-crm-ext' ),
            'text_color_900' => 'rgba(0,0,0,1)',
        );
    }

    public function widget_title() {
        return $this->settings['head_text_900'] ?? '';
    }

    public function widget_bg_color() {
        return 'rgba(255,255,255,1)';
    }

    public function style_settings( $settings ) {
        echo Form::start_form( 0, 'la24-section-box' );
        echo Form::header( __( 'تنظیمات ظاهری:', 'my-crm-ext' ), 12, 'la24-titr' );
        echo Form::color_picker( __( 'رنگ متن', 'my-crm-ext' ), 6, 'text_color_900', 'text_color_900', 'center', $settings['text_color_900'], 0, '' );
        echo Form::close_form();
    }

    public function master_settings( $settings ) {
        echo Form::start_form( 0, 'la24-section-box' );
        echo Form::header( __( 'تنظیمات مدیریتی:', 'my-crm-ext' ), 12, 'la24-titr' );
        echo Form::text_input( __( 'عنوان', 'my-crm-ext' ), 6, 'head_text_900', 'head_text_900', '', $settings['head_text_900'], '', 0 );
        echo Form::close_form();
    }
}

public function content( $settings ) {
    global $wpdb;

    // از get_var برای مقادیر تکی استفاده کنید
    $total = (int) $wpdb->get_var( "SELECT COUNT(*) FROM {$wpdb->prefix}my_table" );

    // از get_results برای آمار گروه‌بندی‌شده استفاده کنید
    $stats = $wpdb->get_results(
        "SELECT status, COUNT(*) as total FROM {$wpdb->prefix}my_table GROUP BY status"
    );
}