daily notes

function wporg_add_dashboard_widgets() {
	// Add function here
}
add_action( 'wp_dashboard_setup', 'wporg_add_dashboard_widgets' );
# wp_network_dashboard_setup to use in network dashboard

function wporg_add_dashboard_widgets() {
	wp_add_dashboard_widget(
		'wporg_dashboard_widget',                          // Widget slug.
		esc_html__( 'Example Dashboard Widget', 'wporg' ), // Title.
		'wporg_dashboard_widget_render'                    // Display function.
	); 
}
add_action( 'wp_dashboard_setup', 'wporg_add_dashboard_widgets' );

function wporg_dashboard_widget_render() {
	esc_html_e( "Howdy! I'm a great Dashboard Widget.", "wporg" );
}

// Create the function to use in the action hook
function wporg_remove_dashboard_widget() {
	remove_meta_box( 'dashboard_quick_press', 'dashboard', 'side' );
} 
// Hook into the 'wp_dashboard_setup' action to register our function
add_action( 'wp_dashboard_setup', 'wporg_remove_dashboard_widget' );

# use these instad of wp_add_dashboard_widget fn to place at custom position
add_meta_box( 
	'dashboard_widget_id', 
	esc_html__( 'Dashboard Widget Title', 'wporg' ), 
	'dashboard_widget', 
	'dashboard', 
	'side', 'high' 
);

<?php
class My_Widget extends WP_Widget {
	public function __construct() {
		parent::__construct(
			'my-text',  // Base ID
			'My Text'   // Name
		);
		add_action( 'widgets_init', function() {
			register_widget( 'My_Widget' );
		});
	}

	public $args = array(
		'before_title'  => '<h4 class="widgettitle">',
		'after_title'   => '</h4>',
		'before_widget' => '<div class="widget-wrap">',
		'after_widget'  => '</div></div>',
	);

	public function widget( $args, $instance ) {
		echo $args['before_widget'];
		if ( ! empty( $instance['title'] ) ) {
			echo $args['before_title'] . apply_filters( 'widget_title', $instance['title'] ) . $args['after_title'];
		}
		echo '<div class="textwidget">';
		echo esc_html__( $instance['text'], 'text_domain' );
		echo '</div>';
		echo $args['after_widget'];
	}

	public function form( $instance ) {
		$title = ! empty( $instance['title'] ) ? $instance['title'] : esc_html__( '', 'text_domain' );
		$text  = ! empty( $instance['text'] ) ? $instance['text'] : esc_html__( '', 'text_domain' );
		?>
		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>"><?php echo esc_html__( 'Title:', 'text_domain' ); ?></label>
			<input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'title' ) ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>">
		</p>
		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'Text' ) ); ?>"><?php echo esc_html__( 'Text:', 'text_domain' ); ?></label>
			<textarea class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'text' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'text' ) ); ?>" type="text" cols="30" rows="10"><?php echo esc_attr( $text ); ?></textarea>
		</p>
		<?php
	}

	public function update( $new_instance, $old_instance ) {
		$instance          = array();
		$instance['title'] = ( ! empty( $new_instance['title'] ) ) ? strip_tags( $new_instance['title'] ) : '';
		$instance['text']  = ( ! empty( $new_instance['text'] ) ) ? $new_instance['text'] : '';
		return $instance;
	}
}
$my_widget = new My_Widget();

request_filesystem_credentials( $url, '', false, false, null )

require_once ABSPATH . 'wp-admin/includes/file.php';

global $wp_filesystem;

if ( ! WP_Filesystem() ) {
    return false;
}

# writing
$file = WP_CONTENT_DIR . '/test.txt';
$content = 'Hello WordPress';

$wp_filesystem->put_contents($file, $content, FS_CHMOD_FILE);

# read
$content = $wp_filesystem->get_contents($file);
# delete
$wp_filesystem->delete($file);

# extra
$upload_dir = wp_upload_dir();  
$dir = $upload_dir['basedir'] . '/myplugin';

FS_CHMOD_FILE = 0644
FS_CHMOD_DIR  = 0755

# addons-pro.php
<?php
/*
 * Addon Name: Pro Features
 * Support Level: Premium
 * Documentation ID: 12345
 */
 
 # retrieval
$file_path = plugin_dir_path( __FILE__ ) . 'addon-pro.php';

$all_headers = array(
    'name'    => 'Addon Name',
    'support' => 'Support Level',
    'doc_id'  => 'Documentation ID',
);

$data = get_file_data( $file_path, $all_headers );

echo $data['name'];    // Outputs: Pro Features
echo $data['support']; // Outputs: Premium

# register category
add_action( 'wp_abilities_api_categories_init', function() {
    wp_register_ability_category( 'ecommerce-tools', array(
        'label' => 'E-commerce Tools',
    ));
});

# register category
add_action( 'wp_abilities_api_init', function() {
    wp_register_ability( 'shop/calculate-discount', array(
        'label'               => 'Calculate Discount',
        'description'         => 'Calculates the loyalty discount for a specific user.',
        'category'            => 'ecommerce-tools',
        'input_schema'        => array(
            'type'       => 'object',
            'properties' => array(
                'user_id' => array( 'type' => 'integer' ),
            ),
            'required'   => array( 'user_id' ),
        ),
        'output_schema'       => array(
            'type'       => 'object',
            'properties' => array(
                'discount_percent' => array( 'type' => 'number' ),
            ),
        ),
        'execute_callback'    => 'my_calculate_discount_logic',
        'permission_callback' => function() {
            return current_user_can( 'manage_options' );
        },
    ));
});

function my_calculate_discount_logic( $params ) {
    $user_id = $params['user_id'];
    // Logic to determine discount...
    return array( 'discount_percent' => 15.5 );
}

// 1. Schedule the action
// as_schedule_single_action( $timestamp, $hook, $args, $group );
as_schedule_single_action( time() + DAY_IN_SECONDS, 'my_custom_followup_email', array( 'user_id' => 123 ) );

// 2. Hook the callback
add_action( 'my_custom_followup_email', 'handle_my_followup_email' );

function handle_my_followup_email( $user_id ) {
    // Your logic here
    error_log( "Sending email to user: " . $user_id );
}


// Schedules a task to run every hour starting now
if ( ! as_has_scheduled_action( 'my_daily_cleanup' ) ) {
    as_schedule_recurring_action( time(), HOUR_IN_SECONDS, 'my_daily_cleanup' );
}

add_action( 'my_daily_cleanup', 'run_cleanup_logic' );
function run_cleanup_logic() {
    // Perform cleanup
}

// wp_cache_set( $key, $data, $group, $expire );
$user_data = array( 'name' => 'John', 'role' => 'Editor' );
wp_cache_set( 'user_profile_123', $user_data, 'my_plugin_users', 3600 ); // Cache for 1 hour

$cached_val = wp_cache_get( 'user_profile_123', 'my_plugin_users' );

if ( false === $cached_val ) {
    // Cache Miss: Run the expensive DB query here
    $cached_val = $wpdb->get_row( "SELECT * FROM ... WHERE id = 123" );
    
    // Save it for next time
    wp_cache_set( 'user_profile_123', $cached_val, 'my_plugin_users' );
}

return $cached_val;

wp_cache_delete( 'user_profile_123', 'my_plugin_users' );