Changeset 27214

Timestamp:

02/20/2014 06:25:01 PM (11 years ago)

Author:

wonderboymusic

Message:

In media-views.js, add wp.media.controller.CollectionAdd and wp.media.controller.CollectionEdit to provide an abstraction for Add and Edit screens in the media modal for collection-type things.

There are currently no instances of this. Those will be forthcoming.

See #26631.

File:

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

trunk/src/wp-includes/js/media-views.js

@@ -759 +759 @@
         }
     });
+
+    /**
+     * wp.media.controller.CollectionEdit
+     *
+     * @static
+     * @param {string} prop The shortcode slug
+     * @param {object} args
+     * @returns {wp.media.controller.Library}
+     */
+    media.controller.CollectionEdit = function ( prop, args ) {
+        /**
+         * @constructor
+         * @augments wp.media.controller.Library
+         * @augments wp.media.controller.State
+         * @augments Backbone.Model
+         */
+        return media.controller.Library.extend({
+            defaults : _.defaults(args.defaults || {}, {
+                id:         prop + '-edit',
+                toolbar:    prop + '-edit',
+                multiple:   false,
+                describe:   true,
+                edge:       199,
+                editing:    false,
+                sortable:   true,
+                searchable: false,
+                content:    'browse',
+                priority:   60,
+                dragInfo:   true,
+
+                // Don't sync the selection, as the Edit {Collection} library
+                // *is* the selection.
+                syncSelection: false
+            }),
+
+            initialize: function() {
+                // If we haven't been provided a `library`, create a `Selection`.
+                if ( ! this.get('library') ) {
+                    this.set( 'library', new media.model.Selection() );
+                }
+                // The single `Attachment` view to be used in the `Attachments` view.
+                if ( ! this.get('AttachmentView') ) {
+                    this.set( 'AttachmentView', media.view.Attachment.EditLibrary );
+                }
+                media.controller.Library.prototype.initialize.apply( this, arguments );
+            },
+
+            activate: function() {
+                var library = this.get('library');
+
+                // Limit the library to images only.
+                library.props.set( 'type', args.type );
+
+                // Watch for uploaded attachments.
+                this.get('library').observe( wp.Uploader.queue );
+
+                this.frame.on( 'content:render:browse', this.settings, this );
+
+                media.controller.Library.prototype.activate.apply( this, arguments );
+            },
+
+            deactivate: function() {
+                // Stop watching for uploaded attachments.
+                this.get('library').unobserve( wp.Uploader.queue );
+
+                this.frame.off( 'content:render:browse', this.settings, this );
+
+                media.controller.Library.prototype.deactivate.apply( this, arguments );
+            },
+
+            settings: function( browser ) {
+                var library = this.get('library'), obj = {};
+
+                if ( ! library || ! browser ) {
+                    return;
+                }
+
+                library[ prop ] = library[ prop ] || new Backbone.Model();
+
+                obj[ prop ] = new media.view.Settings[ args.settings ]({
+                    controller: this,
+                    model:      library[ prop ],
+                    priority:   40
+                });
+
+                browser.sidebar.set( obj );
+
+                if ( args.dragInfoText ) {
+                    browser.toolbar.set( 'dragInfo', new media.View({
+                        el: $( '<div class="instructions">' + args.dragInfoText + '</div>' )[0],
+                        priority: -40
+                    }) );
+                }
+
+                browser.toolbar.set( 'reverse', {
+                    text:     l10n.reverseOrder,
+                    priority: 80,
+
+                    click: function() {
+                        library.reset( library.toArray().reverse() );
+                    }
+                });
+            }
+        });
+    };
+
+    /**
+     * wp.media.controller.CollectionAdd
+     *
+     * @static
+     * @param {string} prop The shortcode slug
+     * @param {object} args
+     * @returns {wp.media.controller.Library}
+     */
+    media.controller.CollectionAdd = function ( prop, args ) {
+        /**
+         * @constructor
+         * @augments wp.media.controller.Library
+         * @augments wp.media.controller.State
+         * @augments Backbone.Model
+         */
+        return media.controller.Library.extend({
+            defaults: _.defaults({
+                id:           prop + '-library',
+                filterable:   'uploaded',
+                multiple:     'add',
+                menu:         prop,
+                toolbar:      prop + '-add',
+                priority:     100,
+                syncSelection: false
+            }, args.defaults || {}, media.controller.Library.prototype.defaults ),
+            initialize: function() {
+                // If we haven't been provided a `library`, create a `Selection`.
+                if ( ! this.get('library') ) {
+                    this.set( 'library', media.query({ type: args.type }) );
+                }
+                media.controller.Library.prototype.initialize.apply( this, arguments );
+            },
+
+            activate: function() {
+                var library = this.get('library'),
+                    edit    = this.frame.state(prop + '-edit').get('library');
+
+                if ( this.editLibrary && this.editLibrary !== edit ) {
+                    library.unobserve( this.editLibrary );
+                }
+
+                // Accepts attachments that exist in the original library and
+                // that do not exist in gallery's library.
+                library.validator = function( attachment ) {
+                    return !! this.mirroring.get( attachment.cid ) && ! edit.get( attachment.cid ) && media.model.Selection.prototype.validator.apply( this, arguments );
+                };
+
+                // Reset the library to ensure that all attachments are re-added
+                // to the collection. Do so silently, as calling `observe` will
+                // trigger the `reset` event.
+                library.reset( library.mirroring.models, { silent: true });
+                library.observe( edit );
+                this.editLibrary = edit;
+
+                media.controller.Library.prototype.activate.apply( this, arguments );
+            }
+        });
+    };
 
     /**