WordPress.org
Get WordPress

Make WordPress Core

Changeset 27362


Ignore:
Timestamp:
03/02/2014 11:10:47 PM (12 years ago)
Author:
wonderboymusic
Message:

Make CollectionEdit and CollectionAdd less dynamically quirky. Rename some instance properties for disambiguation. Pass some properties from options when creating instances in wp.media.view.MediaFrame.Post.

See #26631.
Props gcorne.

File:
1 edited

Legend:

Unmodified
Added
Removed

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

    r27361 r27362  
    763763         * wp.media.controller.CollectionEdit
    764764         *
    765          * @static
    766          * @param {string} prop The shortcode slug
    767          * @param {object} args
    768          * @returns {wp.media.controller.Library}
    769          */
    770         media.controller.CollectionEdit = function ( prop, args ) {
    771                 /**
    772                  * @constructor
    773                  * @augments wp.media.controller.Library
    774                  * @augments wp.media.controller.State
    775                  * @augments Backbone.Model
    776                  */
    777                 return media.controller.Library.extend({
    778                         defaults : _.defaults(args.defaults || {}, {
    779                                 id:         prop + '-edit',
    780                                 toolbar:    prop + '-edit',
    781                                 multiple:   false,
    782                                 describe:   true,
    783                                 edge:       199,
    784                                 editing:    false,
    785                                 sortable:   true,
    786                                 searchable: false,
    787                                 content:    'browse',
    788                                 priority:   60,
    789                                 dragInfo:   true,
    790 
    791                                 // Don't sync the selection, as the Edit {Collection} library
    792                                 // *is* the selection.
    793                                 syncSelection: false
    794                         }),
    795 
    796                         initialize: function() {
    797                                 // If we haven't been provided a `library`, create a `Selection`.
    798                                 if ( ! this.get('library') ) {
    799                                         this.set( 'library', new media.model.Selection() );
    800                                 }
    801                                 // The single `Attachment` view to be used in the `Attachments` view.
    802                                 if ( ! this.get('AttachmentView') ) {
    803                                         this.set( 'AttachmentView', media.view.Attachment.EditLibrary );
    804                                 }
    805                                 media.controller.Library.prototype.initialize.apply( this, arguments );
    806                         },
    807 
    808                         activate: function() {
    809                                 var library = this.get('library');
    810 
    811                                 // Limit the library to images only.
    812                                 library.props.set( 'type', args.type );
    813 
    814                                 // Watch for uploaded attachments.
    815                                 this.get('library').observe( wp.Uploader.queue );
    816 
    817                                 this.frame.on( 'content:render:browse', this.settings, this );
    818 
    819                                 media.controller.Library.prototype.activate.apply( this, arguments );
    820                         },
    821 
    822                         deactivate: function() {
    823                                 // Stop watching for uploaded attachments.
    824                                 this.get('library').unobserve( wp.Uploader.queue );
    825 
    826                                 this.frame.off( 'content:render:browse', this.settings, this );
    827 
    828                                 media.controller.Library.prototype.deactivate.apply( this, arguments );
    829                         },
    830 
    831                         settings: function( browser ) {
    832                                 var library = this.get('library'), obj = {};
    833 
    834                                 if ( ! library || ! browser ) {
    835                                         return;
    836                                 }
    837 
    838                                 library[ prop ] = library[ prop ] || new Backbone.Model();
    839 
    840                                 obj[ prop ] = new media.view.Settings[ args.settings ]({
    841                                         controller: this,
    842                                         model:      library[ prop ],
    843                                         priority:   40
    844                                 });
    845 
    846                                 browser.sidebar.set( obj );
    847 
    848                                 if ( args.dragInfoText ) {
    849                                         browser.toolbar.set( 'dragInfo', new media.View({
    850                                                 el: $( '<div class="instructions">' + args.dragInfoText + '</div>' )[0],
    851                                                 priority: -40
    852                                         }) );
    853                                 }
    854 
    855                                 browser.toolbar.set( 'reverse', {
    856                                         text:     l10n.reverseOrder,
    857                                         priority: 80,
    858 
    859                                         click: function() {
    860                                                 library.reset( library.toArray().reverse() );
    861                                         }
    862                                 });
    863                         }
    864                 });
    865         };
    866 
    867         /**
    868          * wp.media.controller.CollectionAdd
    869          *
    870765         * @constructor
    871766         * @augments wp.media.controller.Library
    … …  
    873768         * @augments Backbone.Model
    874769         */
    875         media.controller.CollectionAdd = function (attributes) {
    876                 var ExtendedLibrary, extended = _.extend( attributes, {
    877                         defaults: _.defaults( {
    878                                 id: attributes.tag + '-library',
    879                                 title: attributes.title,
    880                                 menu: attributes.tag,
    881                                 toolbar: attributes.tag + '-add',
    882                                 filterable: 'uploaded',
    883                                 multiple:   'add',
    884                                 priority:   100,
    885                                 syncSelection: false
    886                         }, media.controller.Library.prototype.defaults ),
    887 
    888                         initialize: function() {
    889                                 // If we haven't been provided a `library`, create a `Selection`.
    890                                 if ( ! this.get('library') ) {
    891                                         this.set( 'library', media.query({ type: this.type }) );
     770        media.controller.CollectionEdit = media.controller.Library.extend({
     771                defaults: {
     772                        multiple:     false,
     773                        describe:     true,
     774                        edge:         199,
     775                        editing:      false,
     776                        sortable:     true,
     777                        searchable:   false,
     778                        content:      'browse',
     779                        priority:     60,
     780                        dragInfo:     true,
     781                        SettingsView: false,
     782
     783                        // Don't sync the selection, as the Edit {Collection} library
     784                        // *is* the selection.
     785                        syncSelection: false
     786                },
     787
     788                initialize: function() {
     789                        var collectionType = this.get('collectionType');
     790
     791                        this.set( 'id', collectionType + '-edit' );
     792                        this.set( 'toolbar', collectionType + '-edit' );
     793
     794                        // If we haven't been provided a `library`, create a `Selection`.
     795                        if ( ! this.get('library') ) {
     796                                this.set( 'library', new media.model.Selection() );
     797                        }
     798                        // The single `Attachment` view to be used in the `Attachments` view.
     799                        if ( ! this.get('AttachmentView') ) {
     800                                this.set( 'AttachmentView', media.view.Attachment.EditLibrary );
     801                        }
     802                        media.controller.Library.prototype.initialize.apply( this, arguments );
     803                },
     804
     805                activate: function() {
     806                        var library = this.get('library');
     807
     808                        // Limit the library to images only.
     809                        library.props.set( 'type', this.get( 'type' ) );
     810
     811                        // Watch for uploaded attachments.
     812                        this.get('library').observe( wp.Uploader.queue );
     813
     814                        this.frame.on( 'content:render:browse', this.renderSettings, this );
     815
     816                        media.controller.Library.prototype.activate.apply( this, arguments );
     817                },
     818
     819                deactivate: function() {
     820                        // Stop watching for uploaded attachments.
     821                        this.get('library').unobserve( wp.Uploader.queue );
     822
     823                        this.frame.off( 'content:render:browse', this.renderSettings, this );
     824
     825                        media.controller.Library.prototype.deactivate.apply( this, arguments );
     826                },
     827
     828                renderSettings: function( browser ) {
     829                        var library = this.get('library'),
     830                                collectionType = this.get('collectionType'),
     831                                dragInfoText = this.get('dragInfoText'),
     832                                SettingsView = this.get('SettingsView'),
     833                                obj = {};
     834
     835                        if ( ! library || ! browser ) {
     836                                return;
     837                        }
     838
     839                        library[ collectionType ] = library[ collectionType ] || new Backbone.Model();
     840
     841                        obj[ collectionType ] = new SettingsView({
     842                                controller: this,
     843                                model:      library[ collectionType ],
     844                                priority:   40
     845                        });
     846
     847                        browser.sidebar.set( obj );
     848
     849                        if ( dragInfoText ) {
     850                                browser.toolbar.set( 'dragInfo', new media.View({
     851                                        el: $( '<div class="instructions">' + dragInfoText + '</div>' )[0],
     852                                        priority: -40
     853                                }) );
     854                        }
     855
     856                        browser.toolbar.set( 'reverse', {
     857                                text:     l10n.reverseOrder,
     858                                priority: 80,
     859
     860                                click: function() {
     861                                        library.reset( library.toArray().reverse() );
    892862                                }
    893                                 media.controller.Library.prototype.initialize.apply( this, arguments );
    894                         },
    895 
    896                         activate: function() {
    897                                 var library = this.get('library'),
    898                                         edit    = this.frame.state( this.tag + '-edit' ).get('library');
    899 
    900                                 if ( this.editLibrary && this.editLibrary !== edit ) {
    901                                         library.unobserve( this.editLibrary );
    902                                 }
    903 
    904                                 // Accepts attachments that exist in the original library and
    905                                 // that do not exist in gallery's library.
    906                                 library.validator = function( attachment ) {
    907                                         return !! this.mirroring.get( attachment.cid ) && ! edit.get( attachment.cid ) && media.model.Selection.prototype.validator.apply( this, arguments );
    908                                 };
    909 
    910                                 // Reset the library to ensure that all attachments are re-added
    911                                 // to the collection. Do so silently, as calling `observe` will
    912                                 // trigger the `reset` event.
    913                                 library.reset( library.mirroring.models, { silent: true });
    914                                 library.observe( edit );
    915                                 this.editLibrary = edit;
    916 
    917                                 media.controller.Library.prototype.activate.apply( this, arguments );
    918                         }
    919                 } );
    920                 ExtendedLibrary = media.controller.Library.extend( extended );
    921 
    922                 return new ExtendedLibrary();
    923         };
    924 
    925         // wp.media.controller.GalleryEdit
    926         // -------------------------------
    927         media.controller.GalleryEdit = media.controller.CollectionEdit( 'gallery', {
    928                 type: 'image',
    929                 settings: 'Gallery',
    930                 defaults: {
    931                         title: l10n.editGalleryTitle
     863                        });
    932864                }
    933865        });
    934866
    935         // wp.media.controller.PlaylistEdit
    936         // -------------------------------
    937         media.controller.PlaylistEdit = media.controller.CollectionEdit( 'playlist', {
    938                 type: 'audio',
    939                 settings: 'Playlist',
    940                 dragInfoText: l10n.playlistDragInfo,
    941                 defaults: {
    942                         title: l10n.editPlaylistTitle,
    943                         dragInfo : false
    944                 }
    945         });
    946 
    947         // wp.media.controller.VideoPlaylistEdit
    948         // -------------------------------
    949         media.controller.VideoPlaylistEdit = media.controller.CollectionEdit( 'video-playlist', {
    950                 type: 'video',
    951                 settings: 'Playlist',
    952                 dragInfoText: l10n.videoPlaylistDragInfo,
    953                 defaults: {
    954                         title: l10n.editVideoPlaylistTitle,
    955                         dragInfo : false
     867        /**
     868         * wp.media.controller.CollectionAdd
     869         *
     870         * @constructor
     871         * @augments wp.media.controller.Library
     872         * @augments wp.media.controller.State
     873         * @augments Backbone.Model
     874         */
     875        media.controller.CollectionAdd = media.controller.Library.extend({
     876                defaults: _.defaults( {
     877                        filterable:    'uploaded',
     878                        multiple:      'add',
     879                        priority:      100,
     880                        syncSelection: false
     881                }, media.controller.Library.prototype.defaults ),
     882
     883                initialize: function() {
     884                        var collectionType = this.get('collectionType');
     885
     886                        this.set( 'id', collectionType + '-library' );
     887                        this.set( 'toolbar', collectionType + '-add' );
     888                        this.set( 'menu', collectionType );
     889
     890                        // If we haven't been provided a `library`, create a `Selection`.
     891                        if ( ! this.get('library') ) {
     892                                this.set( 'library', media.query({ type: this.get('type') }) );
     893                        }
     894                        media.controller.Library.prototype.initialize.apply( this, arguments );
     895                },
     896
     897                activate: function() {
     898                        var library = this.get('library'),
     899                                editLibrary = this.get('editLibrary'),
     900                                edit = this.frame.state( this.get('collectionType') + '-edit' ).get('library');
     901
     902                        if ( editLibrary && editLibrary !== edit ) {
     903                                library.unobserve( editLibrary );
     904                        }
     905
     906                        // Accepts attachments that exist in the original library and
     907                        // that do not exist in gallery's library.
     908                        library.validator = function( attachment ) {
     909                                return !! this.mirroring.get( attachment.cid ) && ! edit.get( attachment.cid ) && media.model.Selection.prototype.validator.apply( this, arguments );
     910                        };
     911
     912                        // Reset the library to ensure that all attachments are re-added
     913                        // to the collection. Do so silently, as calling `observe` will
     914                        // trigger the `reset` event.
     915                        library.reset( library.mirroring.models, { silent: true });
     916                        library.observe( edit );
     917                        this.set('editLibrary', edit);
     918
     919                        media.controller.Library.prototype.activate.apply( this, arguments );
    956920                }
    957921        });
    … …  
    17771741
    17781742                                // Gallery states.
    1779                                 new media.controller.GalleryEdit({
    1780                                         library: options.selection,
    1781                                         editing: options.editing,
    1782                                         menu:    'gallery'
     1743                                new media.controller.CollectionEdit({
     1744                                        type:           'image',
     1745                                        collectionType: 'gallery',
     1746                                        title:           l10n.editGalleryTitle,
     1747                                        SettingsView:    media.view.Settings.Gallery,
     1748                                        library:         options.selection,
     1749                                        editing:         options.editing,
     1750                                        menu:           'gallery'
    17831751                                }),
    17841752
    17851753                                new media.controller.CollectionAdd({
    1786                                         tag: 'gallery',
    1787                                         type: 'image',
    1788                                         title: l10n.addToGalleryTitle
     1754                                        type:           'image',
     1755                                        collectionType: 'gallery',
     1756                                        title:          l10n.addToGalleryTitle
    17891757                                }),
    17901758
    … …  
    18041772
    18051773                                // Playlist states.
    1806                                 new media.controller.PlaylistEdit({
    1807                                         library: options.selection,
    1808                                         editing: options.editing,
    1809                                         menu:    'playlist'
     1774                                new media.controller.CollectionEdit({
     1775                                        type:           'audio',
     1776                                        collectionType: 'playlist',
     1777                                        title:          l10n.editPlaylistTitle,
     1778                                        SettingsView:   media.view.Settings.Playlist,
     1779                                        library:        options.selection,
     1780                                        editing:        options.editing,
     1781                                        menu:           'playlist',
     1782                                        dragInfoText:   l10n.playlistDragInfo,
     1783                                        dragInfo:       false
    18101784                                }),
    18111785
    18121786                                new media.controller.CollectionAdd({
    1813                                         tag: 'playlist',
    18141787                                        type: 'audio',
     1788                                        collectionType: 'playlist',
    18151789                                        title: l10n.addToPlaylistTitle
    18161790                                }),
    … …  
    18311805
    18321806                                // Video Playlist states.
    1833                                 new media.controller.VideoPlaylistEdit({
    1834                                         library: options.selection,
    1835                                         editing: options.editing,
    1836                                         menu:    'video-playlist'
     1807                                new media.controller.CollectionEdit({
     1808                                        type:           'video',
     1809                                        collectionType: 'video-playlist',
     1810                                        title:          l10n.editVideoPlaylistTitle,
     1811                                        SettingsView:   media.view.Settings.Playlist,
     1812                                        library:        options.selection,
     1813                                        editing:        options.editing,
     1814                                        menu:           'video-playlist',
     1815                                        dragInfoText:   l10n.videoPlaylistDragInfo,
     1816                                        dragInfo:       false
    18371817                                }),
    18381818
    18391819                                new media.controller.CollectionAdd({
    1840                                         tag: 'video-playlist',
    1841                                         type: 'video',
    1842                                         title: l10n.addToVideoPlaylistTitle
     1820                                        type:           'video',
     1821                                        collectionType: 'video-playlist',
     1822                                        title:          l10n.addToVideoPlaylistTitle
    18431823                                })
    18441824                        ]);
Note: See TracChangeset for help on using the changeset viewer.