Changeset 3736632

Timestamp:

10/09/2026 12:30:22 PM (2 weeks ago)

Author:

automaize

Message:

1.2.0: Add media library access (GET /staff/media, media_id on image upload)

Location:

automaize-event-calendar/trunk

Files:

• automaize-event-calendar.php (modified) (2 diffs)
• includes/class-aec-events-query.php (modified) (1 diff)
• includes/class-aec-events-write.php (modified) (1 diff)
• includes/class-aec-rest.php (modified) (3 diffs)
• readme.txt (modified) (2 diffs)

automaize-event-calendar/trunk/automaize-event-calendar.php

@@ -3 +3 @@
  * Plugin Name: Automaize Event Calendar
  * Description: Displays upcoming events in a responsive tile grid with recurring event support and optional WooCommerce integration.
- * Version:     1.1.0
+ * Version:     1.2.0
  * Author:      Automaize
  * Author URI:  https://automaize.app
@@ -18 +18 @@
 }
 
-define( 'AMZEC_VERSION', '1.1.0' );
+define( 'AMZEC_VERSION', '1.2.0' );
 define( 'AMZEC_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
 define( 'AMZEC_PLUGIN_URL', plugin_dir_url( __FILE__ ) );

automaize-event-calendar/trunk/includes/class-aec-events-query.php

@@ -120 +120 @@
                 );
         }
+
+        /**
+         * Paginated listing of image attachments already in the WordPress
+         * media library - lets the app offer "choose an existing image"
+         * alongside "upload a new one" when setting an event's featured
+         * image, instead of only ever re-uploading from the device.
+         *
+         * @param int $paged    1-based page number.
+         * @param int $per_page Items per page.
+         * @return array{ attachment_ids: int[], total: int, total_pages: int }
+         */
+        public static function get_media_list( $paged = 1, $per_page = 40 ) {
+                $query = new WP_Query(
+                        array(
+                                'post_type'      => 'attachment',
+                                'post_mime_type' => 'image',
+                                'post_status'    => 'inherit',
+                                'posts_per_page' => $per_page,
+                                'paged'          => max( 1, (int) $paged ),
+                                'orderby'        => 'date',
+                                'order'          => 'DESC',
+                                'fields'         => 'ids',
+                        )
+                );
+
+                return array(
+                        'attachment_ids' => $query->posts,
+                        'total'          => (int) $query->found_posts,
+                        'total_pages'    => (int) $query->max_num_pages,
+                );
+        }
 }

automaize-event-calendar/trunk/includes/class-aec-events-write.php

@@ -161 +161 @@
         }
 
+        /**
+         * Sets an event's featured image to an attachment already in the media
+         * library, instead of uploading a new one - the counterpart to
+         * set_featured_image() for the app's "choose existing image" picker.
+         *
+         * @param int $post_id      Event post ID.
+         * @param int $attachment_id Existing media library attachment ID.
+         * @return int|WP_Error The attachment ID on success.
+         */
+        public static function set_featured_image_from_media( $post_id, $attachment_id ) {
+                $post = get_post( $post_id );
+                if ( ! $post || 'amzec_event' !== $post->post_type ) {
+                        return new WP_Error( 'aec_not_found', __( 'Event not found.', 'automaize-event-calendar' ), array( 'status' => 404 ) );
+                }
+
+                $attachment = get_post( $attachment_id );
+                if ( ! $attachment || 'attachment' !== $attachment->post_type || 0 !== strpos( (string) $attachment->post_mime_type, 'image/' ) ) {
+                        return new WP_Error( 'aec_invalid', __( 'That media item could not be found.', 'automaize-event-calendar' ), array( 'status' => 404 ) );
+                }
+
+                set_post_thumbnail( $post_id, $attachment_id );
+
+                return $attachment_id;
+        }
+
         // -------------------------------------------------------------------------
         // Shared field mapping

automaize-event-calendar/trunk/includes/class-aec-rest.php

@@ -137 +137 @@
                         )
                 );
+
+                register_rest_route(
+                        self::NAMESPACE_,
+                        '/staff/media',
+                        array(
+                                'methods'             => WP_REST_Server::READABLE,
+                                'callback'            => array( __CLASS__, 'list_media' ),
+                                'permission_callback' => array( __CLASS__, 'check_api_key' ),
+                        )
+                );
         }
 
@@ -385 +395 @@
          */
         public static function upload_event_image( WP_REST_Request $request ) {
-                $files = $request->get_file_params();
-
-                if ( empty( $files['file'] ) ) {
-                        return self::error_response( new WP_Error( 'aec_invalid', __( 'Please provide an image file.', 'automaize-event-calendar' ), array( 'status' => 400 ) ) );
-                }
-
-                $attach_id = AMZEC_Events_Write::set_featured_image( absint( $request['id'] ), $files['file'] );
+                $files    = $request->get_file_params();
+                $media_id = absint( $request->get_param( 'media_id' ) );
+
+                if ( ! empty( $files['file'] ) ) {
+                        $attach_id = AMZEC_Events_Write::set_featured_image( absint( $request['id'] ), $files['file'] );
+                } elseif ( $media_id > 0 ) {
+                        // Picked an existing media library item instead of uploading a
+                        // new file - see AMZEC_Events_Query::get_media_list() /
+                        // GET /staff/media.
+                        $attach_id = AMZEC_Events_Write::set_featured_image_from_media( absint( $request['id'] ), $media_id );
+                } else {
+                        return self::error_response( new WP_Error( 'aec_invalid', __( 'Please provide an image file or an existing media_id.', 'automaize-event-calendar' ), array( 'status' => 400 ) ) );
+                }
 
                 if ( is_wp_error( $attach_id ) ) {
@@ -401 +417 @@
                                 'attachment_id' => $attach_id,
                                 'image_url'     => wp_get_attachment_url( $attach_id ),
+                        )
+                );
+        }
+
+        /**
+         * GET /staff/media?page= - paginated image picker for the app's "choose
+         * an existing image" option when setting an event's featured image.
+         *
+         * @param WP_REST_Request $request Request.
+         * @return WP_REST_Response
+         */
+        public static function list_media( WP_REST_Request $request ) {
+                $page   = max( 1, absint( $request->get_param( 'page' ) ) );
+                $result = AMZEC_Events_Query::get_media_list( $page );
+
+                $items = array_map(
+                        function ( $attachment_id ) {
+                                $thumb = wp_get_attachment_image_src( $attachment_id, 'thumbnail' );
+
+                                return array(
+                                        'id'            => $attachment_id,
+                                        'url'           => wp_get_attachment_url( $attachment_id ),
+                                        'thumbnail_url' => $thumb ? $thumb[0] : wp_get_attachment_url( $attachment_id ),
+                                        'title'         => get_the_title( $attachment_id ),
+                                );
+                        },
+                        $result['attachment_ids']
+                );
+
+                return rest_ensure_response(
+                        array(
+                                'items'       => $items,
+                                'total'       => $result['total'],
+                                'total_pages' => $result['total_pages'],
                         )
                 );

automaize-event-calendar/trunk/readme.txt

@@ -5 +5 @@
 Tested up to:      7.0
 Requires PHP:      7.4
-Stable tag:        1.1.0
+Stable tag:        1.2.0
 License:           GPL-2.0-or-later
 License URI:       https://www.gnu.org/licenses/gpl-2.0.html
@@ -79 +79 @@
 == Changelog ==
 
+= 1.2.0 =
+* Added `GET /staff/media`: a paginated listing of existing image attachments in the WordPress media library, so the app can offer "choose an existing image" alongside "upload a new one" when setting an event's featured image. `POST /staff/events/{id}/image` now also accepts a `media_id` of an existing attachment as an alternative to a file upload.
+
 = 1.1.0 =
 * New: REST API for the Kerstins mobile companion app (public event browsing plus an API-key-protected staff surface to create, edit, delete events and upload a featured image — including full recurrence support)