refactor(inc, image-optimizer): restructure /inc architecture and standardize image optimizer module

- reorganized /inc directory structure for improved separation of concerns
  - grouped files into customizer, utilities, and tools
  - improved naming consistency across files (e.g. *-settings, template-tags, etc.)
  - simplified functions.php includes for better readability and maintainability

- refactored Customizer structure
  - extracted image optimizer settings from core-settings into dedicated module
  - consolidated settings, UI logic, and styles into a single feature file
  - improved naming consistency for hooks and functions

- standardized Image Optimizer admin tool
  - renamed "Performance Tools" to "Image Optimizer" across UI and hooks
  - updated admin page registration, callback names, and menu labels
  - aligned AJAX nonce naming for consistency and clarity

- preserved all existing logic and behavior (no functional changes)
- improved overall code organization and long-term maintainability

no breaking changes
This commit is contained in:
2026-04-30 21:41:19 +02:00
parent 84b2b85bf6
commit 1020442c06
14 changed files with 137 additions and 142 deletions
+58
View File
@@ -0,0 +1,58 @@
<?php
/**
* Theme Customizer Core
*
* @package zeitfresser
*/
function zeitfresser_customize_register( $wp_customize ) {
// Live Preview support
$wp_customize->get_setting( 'blogname' )->transport = 'postMessage';
$wp_customize->get_setting( 'blogdescription' )->transport = 'postMessage';
$wp_customize->get_setting( 'header_textcolor' )->transport = 'postMessage';
if ( isset( $wp_customize->selective_refresh ) ) {
$wp_customize->selective_refresh->add_partial(
'blogname',
array(
'selector' => '.site-title a',
'render_callback' => 'zeitfresser_customize_partial_blogname',
)
);
$wp_customize->selective_refresh->add_partial(
'blogdescription',
array(
'selector' => '.site-description',
'render_callback' => 'zeitfresser_customize_partial_blogdescription',
)
);
}
}
add_action( 'customize_register', 'zeitfresser_customize_register' );
/**
* Partial refresh helpers
*/
function zeitfresser_customize_partial_blogname() {
bloginfo( 'name' );
}
function zeitfresser_customize_partial_blogdescription() {
bloginfo( 'description' );
}
/**
* Live preview JS
*/
function zeitfresser_customize_preview_js() {
wp_enqueue_script(
'zeitfresser-customizer',
get_template_directory_uri() . '/js/customizer.js',
array( 'customize-preview' ),
ZEITFRESSER_VERSION,
true
);
}
add_action( 'customize_preview_init', 'zeitfresser_customize_preview_js' );
@@ -1,42 +1,24 @@
<?php
/**
* Theme Customizer Core
* Image Optimizer (Settings + UI)
*
* @package zeitfresser
*/
function zeitfresser_customize_register( $wp_customize ) {
// Live Preview support
$wp_customize->get_setting( 'blogname' )->transport = 'postMessage';
$wp_customize->get_setting( 'blogdescription' )->transport = 'postMessage';
$wp_customize->get_setting( 'header_textcolor' )->transport = 'postMessage';
if ( isset( $wp_customize->selective_refresh ) ) {
$wp_customize->selective_refresh->add_partial(
'blogname',
array(
'selector' => '.site-title a',
'render_callback' => 'zeitfresser_customize_partial_blogname',
)
);
$wp_customize->selective_refresh->add_partial(
'blogdescription',
array(
'selector' => '.site-description',
'render_callback' => 'zeitfresser_customize_partial_blogdescription',
)
);
}
/**
* ------------------------------------------------------------------------
* Settings
* ------------------------------------------------------------------------
*/
function zeitfresser_customize_image_optimizer_settings( $wp_customize ) {
/**
* Performance Tools Section
* Image Optimizer Section
*/
$wp_customize->add_section(
'ztfr_performance_tools',
'ztfr_image_optimizer',
array(
'title' => 'Performance Tools Settings',
'title' => 'Image Optimizer',
'priority' => 160,
)
);
@@ -56,7 +38,7 @@ function zeitfresser_customize_register( $wp_customize ) {
'ztfr_auto_optimize',
array(
'type' => 'checkbox',
'section' => 'ztfr_performance_tools',
'section' => 'ztfr_image_optimizer',
'label' => 'Auto Optimize Pictures on Upload',
'description' => 'Automatically converts images to AVIF/WebP.',
)
@@ -77,43 +59,21 @@ function zeitfresser_customize_register( $wp_customize ) {
'ztfr_auto_delete',
array(
'type' => 'checkbox',
'section' => 'ztfr_performance_tools',
'section' => 'ztfr_image_optimizer',
'label' => 'Auto Delete Original Pictures',
'description' => 'Deletes originals after optimization.',
)
);
}
add_action( 'customize_register', 'zeitfresser_customize_register' );
add_action( 'customize_register', 'zeitfresser_customize_image_optimizer_settings' );
/**
* Partial refresh helpers
* ------------------------------------------------------------------------
* UI Logic (JS)
* ------------------------------------------------------------------------
*/
function zeitfresser_customize_partial_blogname() {
bloginfo( 'name' );
}
function zeitfresser_customize_partial_blogdescription() {
bloginfo( 'description' );
}
/**
* Live preview JS
*/
function zeitfresser_customize_preview_js() {
wp_enqueue_script(
'zeitfresser-customizer',
get_template_directory_uri() . '/js/customizer.js',
array( 'customize-preview' ),
ZEITFRESSER_VERSION,
true
);
}
add_action( 'customize_preview_init', 'zeitfresser_customize_preview_js' );
/**
* Dependency UI logic
*/
function zeitfresser_customize_controls_dependency_js() {
function zeitfresser_customize_image_optimizer_ui() {
?>
<script>
(function() {
@@ -193,7 +153,6 @@ function zeitfresser_customize_controls_dependency_js() {
return;
}
// Retry max 10x
if (attempts < 10) {
attempts++;
setTimeout(tryInit, 200);
@@ -225,20 +184,27 @@ function zeitfresser_customize_controls_dependency_js() {
</script>
<?php
}
add_action( 'customize_controls_enqueue_scripts', 'zeitfresser_customize_controls_dependency_js' );
add_action( 'customize_controls_enqueue_scripts', 'zeitfresser_customize_image_optimizer_ui' );
/**
* Small UI polish
* ------------------------------------------------------------------------
* UI Styles
* ------------------------------------------------------------------------
*/
add_action( 'customize_controls_enqueue_scripts', function() {
?>
<style>
#customize-control-ztfr_auto_optimize > label,
#customize-control-ztfr_auto_delete > label {
display:flex;
align-items:flex-start;
gap:6px;
function zeitfresser_customize_image_optimizer_ui_styles() {
?>
<style>
#customize-control-ztfr_auto_optimize > label,
#customize-control-ztfr_auto_delete > label {
display:flex;
align-items:flex-start;
gap:6px;
}
</style>
<?php
}
</style>
<?php
});
add_action(
'customize_controls_enqueue_scripts',
'zeitfresser_customize_image_optimizer_ui_styles'
);
@@ -1,6 +1,6 @@
<?php
/**
* Performance tools for existing media.
* Image Optimizer
*
* @package zeitfresser
*/
@@ -12,16 +12,16 @@ if ( ! defined( 'ABSPATH' ) ) {
/**
* Register admin page
*/
function zeitfresser_register_performance_tools_page() {
function zeitfresser_register_image_optimizer_page() {
add_theme_page(
'Performance Tools',
'Performance Tools',
'Image Optimizer',
'Image Optimizer',
'manage_options',
'zeitfresser-performance-tools',
'zeitfresser_render_performance_tools_page'
'zeitfresser-image-optimizer',
'zeitfresser_render_image_optimizer_page'
);
}
add_action( 'admin_menu', 'zeitfresser_register_performance_tools_page' );
add_action( 'admin_menu', 'zeitfresser_register_image_optimizer_page' );
/**
* Count pending images
@@ -427,7 +427,7 @@ function zeitfresser_ajax_optimize_images() {
wp_send_json_error();
}
check_ajax_referer( 'zeitfresser_performance_tools', 'nonce' );
check_ajax_referer( 'zeitfresser_image_optimizer', 'nonce' );
$results = zeitfresser_process_legacy_images_batch( 25 );
@@ -465,7 +465,7 @@ function zeitfresser_ajax_delete_originals() {
wp_send_json_error();
}
check_ajax_referer( 'zeitfresser_performance_tools', 'nonce' );
check_ajax_referer( 'zeitfresser_image_optimizer', 'nonce' );
$deleted = zeitfresser_delete_originals_batch( 10 );
$total = zeitfresser_get_total_originals_count();
@@ -486,7 +486,7 @@ add_action( 'wp_ajax_zeitfresser_delete_originals', 'zeitfresser_ajax_delete_ori
/**
* Render UI
*/
function zeitfresser_render_performance_tools_page() {
function zeitfresser_render_image_optimizer_page() {
if ( ! current_user_can( 'manage_options' ) ) {
return;
@@ -519,7 +519,7 @@ function zeitfresser_render_performance_tools_page() {
?>
<div class="wrap">
<h1>Zeitfresser Performance Tools</h1>
<h1>Zeitfresser Image Optimizer</h1>
<div class="notice notice-info" style="max-width:800px;margin-top:20px;">
<p>
@@ -532,7 +532,7 @@ function zeitfresser_render_performance_tools_page() {
Once optimized, original images can be deleted to save disk space.<br><br>
<strong>Automation:</strong><br>
You can enable automatic optimization on upload in the Customizer under <em>Performance Tools Settings</em>.<br>
You can enable automatic optimization on upload in the Customizer under <em>Image Optimizer Settings</em>.<br>
Optionally, original images can also be deleted automatically after successful optimization.<br><br>
<strong>Safety:</strong><br>
@@ -653,7 +653,7 @@ function deleteBatch() {
headers: {'Content-Type': 'application/x-www-form-urlencoded'},
body: new URLSearchParams({
action: 'zeitfresser_delete_originals',
nonce: '<?php echo wp_create_nonce('zeitfresser_performance_tools'); ?>'
nonce: '<?php echo wp_create_nonce('zeitfresser_image_optimizer'); ?>'
})
})
.then(res => res.json())
@@ -732,7 +732,7 @@ function processBatch() {
headers: {'Content-Type': 'application/x-www-form-urlencoded'},
body: new URLSearchParams({
action: 'zeitfresser_optimize_images',
nonce: '<?php echo wp_create_nonce('zeitfresser_performance_tools'); ?>'
nonce: '<?php echo wp_create_nonce('zeitfresser_image_optimizer'); ?>'
})
})
.then(res => res.json())