Source: rest/Folder.class.php

<?php
namespace MatthiasWeb\RealMediaLibrary\rest;
use MatthiasWeb\RealMediaLibrary\base;
use MatthiasWeb\RealMediaLibrary\general;
use MatthiasWeb\RealMediaLibrary\attachment;
use MatthiasWeb\RealMediaLibrary\order;
use MatthiasWeb\RealMediaLibrary\metadata;

defined( 'ABSPATH' ) or die( 'No script kiddies please!' ); // Avoid direct file request

/**
 * Enables the /folders REST for all creatable items.
 */
class Folder extends base\Base {
    /**
     * Register endpoints.
     */
    public function rest_api_init() {
        register_rest_route(Service::SERVICE_NAMESPACE, '/folders/content/counts', array(
            'methods' => 'GET',
            'callback' => array($this, 'getContentCounts')
        ));
        
        register_rest_route(Service::SERVICE_NAMESPACE, '/folders/content/sortables', array(
            'methods' => 'GET',
            'callback' => array($this, 'getContentSortables')
        ));
        
        register_rest_route(Service::SERVICE_NAMESPACE, '/folders/content/sortables', array(
            'methods' => 'POST',
            'callback' => array($this, 'applyContentSortables')
        ));
        
        register_rest_route(Service::SERVICE_NAMESPACE, '/folders/(?P<id>\d+)/meta', array(
            'methods' => 'GET',
            'callback' => array($this, 'getMetaHTML')
        ));
        
        register_rest_route(Service::SERVICE_NAMESPACE, '/folders/(?P<id>\d+)/meta', array(
            'methods' => 'PUT',
            'callback' => array($this, 'updateMeta')
        ));
        
        register_rest_route(Service::SERVICE_NAMESPACE, '/folders/(?P<id>\d+)', array(
            'methods' => 'PUT',
            'callback' => array($this, 'updateItem')
        ));
        
        register_rest_route(Service::SERVICE_NAMESPACE, '/folders/(?P<id>\d+)', array(
            'methods' => 'DELETE',
            'callback' => array($this, 'deleteItem')
        ));
        
        register_rest_route(Service::SERVICE_NAMESPACE, '/folders', array(
            'methods' => 'POST',
            'callback' => array($this, 'createItem')
        ));
    }
    
    /**
     * @api {get} /realmedialibrary/v1/folders/content/counts Get all folder counts
     * @apiName GetFolderContentCounts
     * @apiGroup Folder
     * @apiVersion 1.0.0
     */
    public function getContentCounts($request) {
        return new \WP_REST_Response(attachment\Structure::getInstance()->getFolderCounts());
    }
    
    /**
     * @api {get} /realmedialibrary/v1/folders/content/sortable Get the available sortables
     * @apiName GetFolderContentSortables
     * @apiGroup Folder
     * @apiVersion 1.0.0
     */
    public function getContentSortables($request) {
        $_sortables = order\GalleryOrder::getInstance()->getAvailableOrders();
        $sortables = array();
        foreach ($_sortables as $key => $value) {
            $sortables[$key] = $value["label"];
        }
        return new \WP_REST_Response($sortables);
    }
    
    /**
     * @api {post} /realmedialibrary/v1/folders/content/sortable Set a folders content order
     * @apiParam {string} id The sortable id. Pass "original" to reset the folder,
     *  pass "deactivate" to deactive the automatic order,
     *  pass "reindex" to reindex the order indexes,
     *  pass "last" to try to to reset to the last available order
     * @apiParam {int} applyTo The folder id
     * @apiParam {boolean} [automatically] Automatically use this order when new files are added to the folder
     * @apiName ApplyFolderContentSorting
     * @apiGroup Folder
     * @apiVersion 1.0.0
     */
    public function applyContentSortables($request) {
        $sortable = $request->get_param('id');
        $applyTo = $request->get_param('applyTo');
        $automatically = $request->get_param('automatically');
        $automatically = gettype($automatically) === 'string' ? $automatically === 'true' : $automatically;
        $folder = wp_rml_get_object_by_id($applyTo);
        $isFolder = is_rml_folder($folder);
        $result = false;
        if ($sortable === 'original') {
            $result = $isFolder && $folder->contentDeleteOrder();
        }else if ($sortable === 'deactivate') {
            $result = update_media_folder_meta($folder->getId(), 'orderAutomatically', false);
        }else if ($sortable === 'reindex') {
            $result = $isFolder && $folder->contentReindex();
        }else if ($sortable === 'last') {
            $result = $isFolder && $folder->getContentOldCustomNrCount() > 0 && $folder->contentRestoreOldCustomNr();
        }else{
            $result = $isFolder && order\GalleryOrder::getInstance()->order($applyTo, $sortable);
            if ($result) {
                update_media_folder_meta($folder->getId(), 'orderAutomatically', $automatically);
            }
        }
        return new \WP_REST_Response($result);
    }
    
    /**
     * @api {post} /realmedialibrary/v1/folders Create a new folder
     * @apiParam {string} name The new name for the folder
     * @apiParam {int} parent The parent
     * @apiParam {string} type The folder type
     * @apiName DeleteFolder
     * @apiGroup Folder
     * @apiVersion 1.0.0
     */
    public function createItem($request) {
        $name = $request->get_param('name');
        $parent = $request->get_param('parent');
        $type = $request->get_param('type');
        
        $insert = wp_rml_create($name, $parent, $type);
        
        if (is_array($insert)) {
            return new \WP_Error('rest_rml_folder_create_failed', implode(' ', $insert), array('status' => 500));
        }else{
            return new \WP_REST_Response(wp_rml_get_object_by_id($insert)->getPlain());
        }
    }
    
    /**
     * @api {delete} /realmedialibrary/v1/folders/:id Delete a folder by id
     * @apiName DeleteFolder
     * @apiGroup Folder
     * @apiVersion 1.0.0
     */
    public function deleteItem($request) {
        $id = $request->get_param('id');
        
        $delete = wp_rml_delete($id);
        
        if ($delete === true) {
            return new \WP_REST_Response($delete);
        }else{
            return new \WP_Error('rest_rml_folder_delete', implode(' ', $delete), array('status' => 500));
        }
    }
    
    /**
     * @api {get} /realmedialibrary/v1/folders/:id/meta Get the HTML meta content
     * @apiName GetFolderMeta
     * @apiGroup Folder
     * @apiVersion 1.0.0
     */
    public function getMetaHTML($request) {
        $id = $request->get_param('id');
        return new \WP_REST_Response(array(
            'html' => metadata\Meta::getInstance()->prepare_content($id)
        ));
    }
    
    /**
     * @api {put} /realmedialibrary/v1/folders/:id/meta Update meta of a folder
     * @apiDescription Send a key value map of form data so Meta implementations (IMetadata) can handle it
     * @apiName UpdateFolderMeta
     * @apiGroup Folder
     * @apiVersion 1.0.0
     */
    public function updateMeta($request) {
        $folder = wp_rml_get_object_by_id($request->get_param('id'));
        if (!is_rml_folder($folder)) {
            return new \WP_Error('rest_rml_folder_meta_update_not_found', 'Not found', array('status' => 404));
        }
        
        /**
         * This filter is called to save the metadata. You can use the $_POST
         * fields to validate the input. If an error occurs you can pass an
         * "error" array (string) to the response. Do not use this filter directly instead use the 
         * add_rml_meta_box() function!
         * 
         * @param {array} $response The response passed to the frontend
         * @param {WP_REST_Request} $request The server request
         * @hook RML/Folder/Meta/Save
         * @returns {array}
         */
        $response = apply_filters("RML/Folder/Meta/Save", array(), $folder, $request);
        
        if (is_array($response) && isset($response["errors"]) && count($response["errors"]) > 0) {
            return new \WP_Error('rest_rml_folder_update', $response["errors"], array('status' => 500));
        }else{
            if (isset($response["data"]) && is_array($response["data"])) {
                $response = $response["data"];
            }
            return new \WP_REST_Response($response);
        }
    }
    
    /**
     * @api {put} /realmedialibrary/v1/folders/:id Update a folder by id
     * @apiParam {string} name The new name for the folder
     * @apiName UpdateFolder
     * @apiGroup Folder
     * @apiVersion 1.0.0
     */
    public function updateItem($request) {
        $name = $request->get_param('name');
        $id = $request->get_param('id');
        
        $update = wp_rml_rename($name, $id);
        
        if ($update === true) {
            $folder = wp_rml_get_by_id($id, null, true);
            return new \WP_REST_Response($folder->getPlain());
        }else{
            return new \WP_Error('rest_rml_folder_update', implode(' ', $update), array('status' => 500));
        }
    }
}