Changeset 21692

Timestamp:

08/31/2012 08:44:02 PM (13 years ago)

Author:

koopersmith

Message:

Add wp.media(), a function to create a default media workflow.

This will be the main entry point for basic media development, and should hopefully help less experienced developers wrangle the new media APIs.

If you would like to see the new UI, navigate to the post editor and run the following in your browser's Javascript console:

wp.media();

Well, that certainly feels a lot nicer to type.

see #21390.

File:

• trunk/wp-includes/js/media-models.js (modified) (1 diff)

trunk/wp-includes/js/media-models.js

@@ -3 +3 @@
 
 (function($){
-    var media = wp.media = { model: {}, view: {}, controller: {} },
-        Attachment, Attachments, Query;
+    var Attachment, Attachments, Query;
+
+    /**
+     * wp.media( attributes )
+     *
+     * Handles the default media experience. Automatically creates
+     * and opens a media workflow, and returns the result.
+     * Does nothing if the controllers do not exist.
+     *
+     * @param  {object} attributes The properties passed to the main media controller.
+     * @return {object}            A media workflow.
+     */
+    media = wp.media = function( attributes ) {
+        if ( media.controller.Workflow )
+            return new media.controller.Workflow( attributes ).render();
+    };
+
+    _.extend( media, { model: {}, view: {}, controller: {} });
 
     /**