1 /* global _wpThemeSettings, confirm */
2 window.wp = window.wp || {};
6 // Set up our namespace...
8 themes = wp.themes = wp.themes || {};
10 // Store the theme data and settings for organized and quick access
11 // themes.data.settings, themes.data.themes, themes.data.l10n
12 themes.data = _wpThemeSettings;
13 l10n = themes.data.l10n;
15 // Shortcut for isInstall check
16 themes.isInstall = !! themes.data.settings.isInstall;
18 // Setup app structure
19 _.extend( themes, { model: {}, view: {}, routes: {}, router: {}, template: wp.template });
21 themes.Model = Backbone.Model.extend({
22 // Adds attributes to the default data coming through the .org themes api
23 // Map `id` to `slug` for shared code
24 initialize: function() {
27 // If theme is already installed, set an attribute.
28 if ( _.indexOf( themes.data.installedThemes, this.get( 'slug' ) ) !== -1 ) {
29 this.set({ installed: true });
34 // slug is for installation, id is for existing.
35 id: this.get( 'slug' ) || this.get( 'id' )
38 // Map `section.description` to `description`
39 // as the API sometimes returns it differently
40 if ( this.has( 'sections' ) ) {
41 description = this.get( 'sections' ).description;
42 this.set({ description: description });
47 // Main view controller for themes.php
48 // Unifies and renders all available views
49 themes.view.Appearance = wp.Backbone.View.extend({
51 el: '#wpbody-content .wrap .theme-browser',
54 // Pagination instance
57 // Sets up a throttler for binding to 'scroll'
58 initialize: function( options ) {
59 // Scroller checks how far the scroll position is
60 _.bindAll( this, 'scroller' );
62 this.SearchView = options.SearchView ? options.SearchView : themes.view.Search;
63 // Bind to the scroll event and throttle
64 // the results from this.scroller
65 this.window.bind( 'scroll', _.throttle( this.scroller, 300 ) );
68 // Main render control
70 // Setup the main theme view
71 // with the current theme collection
72 this.view = new themes.view.Themes({
73 collection: this.collection,
77 // Render search form.
82 this.$el.empty().append( this.view.el ).addClass( 'rendered' );
83 this.$el.append( '<br class="clear"/>' );
86 // Defines search element container
87 searchContainer: $( '#wpbody h1:first' ),
89 // Search input and view
90 // for current theme collection
95 // Don't render the search if there is only one theme
96 if ( themes.data.themes.length === 1 ) {
100 view = new this.SearchView({
101 collection: self.collection,
105 // Render and append after screen title
108 .append( $.parseHTML( '<label class="screen-reader-text" for="wp-filter-search-input">' + l10n.search + '</label>' ) )
112 // Checks when the user gets close to the bottom
113 // of the mage and triggers a theme:scroll event
114 scroller: function() {
118 bottom = this.window.scrollTop() + self.window.height();
119 threshold = self.$el.offset().top + self.$el.outerHeight( false ) - self.window.height();
120 threshold = Math.round( threshold * 0.9 );
122 if ( bottom > threshold ) {
123 this.trigger( 'theme:scroll' );
128 // Set up the Collection for our theme data
129 // @has 'id' 'name' 'screenshot' 'author' 'authorURI' 'version' 'active' ...
130 themes.Collection = Backbone.Collection.extend({
137 // Controls searching on the current theme collection
138 // and triggers an update event
139 doSearch: function( value ) {
141 // Don't do anything if we've already done this search
142 // Useful because the Search handler fires multiple times per keystroke
143 if ( this.terms === value ) {
147 // Updates terms with the value passed
150 // If we have terms, run a search...
151 if ( this.terms.length > 0 ) {
152 this.search( this.terms );
155 // If search is blank, show all themes
156 // Useful for resetting the views when you clean the input
157 if ( this.terms === '' ) {
158 this.reset( themes.data.themes );
159 $( 'body' ).removeClass( 'no-results' );
162 // Trigger an 'update' event
163 this.trigger( 'update' );
166 // Performs a search within the collection
168 search: function( term ) {
169 var match, results, haystack, name, description, author;
171 // Start with a full collection
172 this.reset( themes.data.themes, { silent: true } );
174 // Escape the term string for RegExp meta characters
175 term = term.replace( /[-\/\\^$*+?.()|[\]{}]/g, '\\$&' );
177 // Consider spaces as word delimiters and match the whole string
178 // so matching terms can be combined
179 term = term.replace( / /g, ')(?=.*' );
180 match = new RegExp( '^(?=.*' + term + ').+', 'i' );
183 // _.filter and .test
184 results = this.filter( function( data ) {
185 name = data.get( 'name' ).replace( /(<([^>]+)>)/ig, '' );
186 description = data.get( 'description' ).replace( /(<([^>]+)>)/ig, '' );
187 author = data.get( 'author' ).replace( /(<([^>]+)>)/ig, '' );
189 haystack = _.union( name, data.get( 'id' ), description, author, data.get( 'tags' ) );
191 if ( match.test( data.get( 'author' ) ) && term.length > 2 ) {
192 data.set( 'displayAuthor', true );
195 return match.test( haystack );
198 if ( results.length === 0 ) {
199 this.trigger( 'query:empty' );
201 $( 'body' ).removeClass( 'no-results' );
204 this.reset( results );
207 // Paginates the collection with a helper method
208 // that slices the collection
209 paginate: function( instance ) {
210 var collection = this;
211 instance = instance || 0;
213 // Themes per instance are set at 20
214 collection = _( collection.rest( 20 * instance ) );
215 collection = _( collection.first( 20 ) );
222 // Handles requests for more themes
223 // and caches results
225 // When we are missing a cache object we fire an apiCall()
226 // which triggers events of `query:success` or `query:fail`
227 query: function( request ) {
232 var queries = this.queries,
234 query, isPaginated, count;
236 // Store current query request args
237 // for later use with the event `theme:end`
238 this.currentQuery.request = request;
240 // Search the query cache for matches.
241 query = _.find( queries, function( query ) {
242 return _.isEqual( query.request, request );
245 // If the request matches the stored currentQuery.request
246 // it means we have a paginated request.
247 isPaginated = _.has( request, 'page' );
249 // Reset the internal api page counter for non paginated queries.
250 if ( ! isPaginated ) {
251 this.currentQuery.page = 1;
254 // Otherwise, send a new API call and add it to the cache.
255 if ( ! query && ! isPaginated ) {
256 query = this.apiCall( request ).done( function( data ) {
258 // Update the collection with the queried data.
260 self.reset( data.themes );
261 count = data.info.results;
262 // Store the results and the query request
263 queries.push( { themes: data.themes, request: request, total: count } );
266 // Trigger a collection refresh event
267 // and a `query:success` event with a `count` argument.
268 self.trigger( 'update' );
269 self.trigger( 'query:success', count );
271 if ( data.themes && data.themes.length === 0 ) {
272 self.trigger( 'query:empty' );
275 }).fail( function() {
276 self.trigger( 'query:fail' );
279 // If it's a paginated request we need to fetch more themes...
281 return this.apiCall( request, isPaginated ).done( function( data ) {
282 // Add the new themes to the current collection
283 // @todo update counter
284 self.add( data.themes );
285 self.trigger( 'query:success' );
287 // We are done loading themes for now.
288 self.loadingThemes = false;
290 }).fail( function() {
291 self.trigger( 'query:fail' );
295 if ( query.themes.length === 0 ) {
296 self.trigger( 'query:empty' );
298 $( 'body' ).removeClass( 'no-results' );
301 // Only trigger an update event since we already have the themes
302 // on our cached object
303 if ( _.isNumber( query.total ) ) {
304 this.count = query.total;
307 this.reset( query.themes );
308 if ( ! query.total ) {
309 this.count = this.length;
312 this.trigger( 'update' );
313 this.trigger( 'query:success', this.count );
317 // Local cache array for API queries
320 // Keep track of current query so we can handle pagination
326 // Send request to api.wordpress.org/themes
327 apiCall: function( request, paginated ) {
328 return wp.ajax.send( 'query-themes', {
347 beforeSend: function() {
350 $( 'body' ).addClass( 'loading-content' ).removeClass( 'no-results' );
356 // Static status controller for when we are loading themes.
360 // This is the view that controls each theme item
361 // that will be displayed on the screen
362 themes.view.Theme = wp.Backbone.View.extend({
364 // Wrap theme data on a div.theme element
367 // Reflects which theme view we have
368 // 'grid' (default) or 'detail'
371 // The HTML template for each element to be rendered
372 html: themes.template( 'theme' ),
375 'click': themes.isInstall ? 'preview': 'expand',
376 'keydown': themes.isInstall ? 'preview': 'expand',
377 'touchend': themes.isInstall ? 'preview': 'expand',
379 'touchmove': 'preventExpand'
385 var data = this.model.toJSON();
386 // Render themes using the html template
387 this.$el.html( this.html( data ) ).attr({
389 'aria-describedby' : data.id + '-action ' + data.id + '-name'
392 // Renders active theme styles
395 if ( this.model.get( 'displayAuthor' ) ) {
396 this.$el.addClass( 'display-author' );
399 if ( this.model.get( 'installed' ) ) {
400 this.$el.addClass( 'is-installed' );
404 // Adds a class to the currently active theme
405 // and to the overlay in detailed view mode
406 activeTheme: function() {
407 if ( this.model.get( 'active' ) ) {
408 this.$el.addClass( 'active' );
412 // Add class of focus to the theme we are focused on.
413 addFocus: function() {
414 var $themeToFocus = ( $( ':focus' ).hasClass( 'theme' ) ) ? $( ':focus' ) : $(':focus').parents('.theme');
416 $('.theme.focus').removeClass('focus');
417 $themeToFocus.addClass('focus');
420 // Single theme overlay screen
421 // It's shown when clicking a theme
422 expand: function( event ) {
425 event = event || window.event;
427 // 'enter' and 'space' keys expand the details view when a theme is :focused
428 if ( event.type === 'keydown' && ( event.which !== 13 && event.which !== 32 ) ) {
432 // Bail if the user scrolled on a touch device
433 if ( this.touchDrag === true ) {
434 return this.touchDrag = false;
437 // Prevent the modal from showing when the user clicks
438 // one of the direct action buttons
439 if ( $( event.target ).is( '.theme-actions a' ) ) {
443 // Set focused theme to current element
444 themes.focusedTheme = this.$el;
446 this.trigger( 'theme:expand', self.model.cid );
449 preventExpand: function() {
450 this.touchDrag = true;
453 preview: function( event ) {
457 event = event || window.event;
459 // Bail if the user scrolled on a touch device
460 if ( this.touchDrag === true ) {
461 return this.touchDrag = false;
464 // Allow direct link path to installing a theme.
465 if ( $( event.target ).hasClass( 'button-primary' ) ) {
469 // 'enter' and 'space' keys expand the details view when a theme is :focused
470 if ( event.type === 'keydown' && ( event.which !== 13 && event.which !== 32 ) ) {
474 // pressing enter while focused on the buttons shouldn't open the preview
475 if ( event.type === 'keydown' && event.which !== 13 && $( ':focus' ).hasClass( 'button' ) ) {
479 event.preventDefault();
481 event = event || window.event;
483 // Set focus to current theme.
484 themes.focusedTheme = this.$el;
486 // Construct a new Preview view.
487 preview = new themes.view.Preview({
491 // Render the view and append it.
493 this.setNavButtonsState();
495 // Hide previous/next navigation if there is only one theme
496 if ( this.model.collection.length === 1 ) {
497 preview.$el.addClass( 'no-navigation' );
499 preview.$el.removeClass( 'no-navigation' );
503 $( 'div.wrap' ).append( preview.el );
505 // Listen to our preview object
506 // for `theme:next` and `theme:previous` events.
507 this.listenTo( preview, 'theme:next', function() {
509 // Keep local track of current theme model.
510 current = self.model;
512 // If we have ventured away from current model update the current model position.
513 if ( ! _.isUndefined( self.current ) ) {
514 current = self.current;
517 // Get next theme model.
518 self.current = self.model.collection.at( self.model.collection.indexOf( current ) + 1 );
520 // If we have no more themes, bail.
521 if ( _.isUndefined( self.current ) ) {
522 self.options.parent.parent.trigger( 'theme:end' );
523 return self.current = current;
526 preview.model = self.current;
528 // Render and append.
530 this.setNavButtonsState();
531 $( '.next-theme' ).focus();
533 .listenTo( preview, 'theme:previous', function() {
535 // Keep track of current theme model.
536 current = self.model;
538 // Bail early if we are at the beginning of the collection
539 if ( self.model.collection.indexOf( self.current ) === 0 ) {
543 // If we have ventured away from current model update the current model position.
544 if ( ! _.isUndefined( self.current ) ) {
545 current = self.current;
548 // Get previous theme model.
549 self.current = self.model.collection.at( self.model.collection.indexOf( current ) - 1 );
551 // If we have no more themes, bail.
552 if ( _.isUndefined( self.current ) ) {
556 preview.model = self.current;
558 // Render and append.
560 this.setNavButtonsState();
561 $( '.previous-theme' ).focus();
564 this.listenTo( preview, 'preview:close', function() {
565 self.current = self.model;
569 // Handles .disabled classes for previous/next buttons in theme installer preview
570 setNavButtonsState: function() {
571 var $themeInstaller = $( '.theme-install-overlay' ),
572 current = _.isUndefined( this.current ) ? this.model : this.current;
574 // Disable previous at the zero position
575 if ( 0 === this.model.collection.indexOf( current ) ) {
576 $themeInstaller.find( '.previous-theme' ).addClass( 'disabled' );
579 // Disable next if the next model is undefined
580 if ( _.isUndefined( this.model.collection.at( this.model.collection.indexOf( current ) + 1 ) ) ) {
581 $themeInstaller.find( '.next-theme' ).addClass( 'disabled' );
586 // Theme Details view
587 // Set ups a modal overlay with the expanded theme data
588 themes.view.Details = wp.Backbone.View.extend({
590 // Wrap theme data on a div.theme element
591 className: 'theme-overlay',
595 'click .delete-theme': 'deleteTheme',
596 'click .left': 'previousTheme',
597 'click .right': 'nextTheme'
600 // The HTML template for the theme overlay
601 html: themes.template( 'theme-single' ),
604 var data = this.model.toJSON();
605 this.$el.html( this.html( data ) );
606 // Renders active theme styles
608 // Set up navigation events
610 // Checks screenshot size
611 this.screenshotCheck( this.$el );
612 // Contain "tabbing" inside the overlay
613 this.containFocus( this.$el );
616 // Adds a class to the currently active theme
617 // and to the overlay in detailed view mode
618 activeTheme: function() {
619 // Check the model has the active property
620 this.$el.toggleClass( 'active', this.model.get( 'active' ) );
623 // Keeps :focus within the theme details elements
624 containFocus: function( $el ) {
627 // Move focus to the primary action
628 _.delay( function() {
629 $( '.theme-wrap a.button-primary:visible' ).focus();
632 $el.on( 'keydown.wp-themes', function( event ) {
635 if ( event.which === 9 ) {
636 $target = $( event.target );
638 // Keep focus within the overlay by making the last link on theme actions
639 // switch focus to button.left on tabbing and vice versa
640 if ( $target.is( 'button.left' ) && event.shiftKey ) {
641 $el.find( '.theme-actions a:last-child' ).focus();
642 event.preventDefault();
643 } else if ( $target.is( '.theme-actions a:last-child' ) ) {
644 $el.find( 'button.left' ).focus();
645 event.preventDefault();
651 // Single theme overlay screen
652 // It's shown when clicking a theme
653 collapse: function( event ) {
657 event = event || window.event;
659 // Prevent collapsing detailed view when there is only one theme available
660 if ( themes.data.themes.length === 1 ) {
664 // Detect if the click is inside the overlay
665 // and don't close it unless the target was
666 // the div.back button
667 if ( $( event.target ).is( '.theme-backdrop' ) || $( event.target ).is( '.close' ) || event.keyCode === 27 ) {
669 // Add a temporary closing class while overlay fades out
670 $( 'body' ).addClass( 'closing-overlay' );
672 // With a quick fade out animation
673 this.$el.fadeOut( 130, function() {
674 // Clicking outside the modal box closes the overlay
675 $( 'body' ).removeClass( 'closing-overlay' );
676 // Handle event cleanup
679 // Get scroll position to avoid jumping to the top
680 scroll = document.body.scrollTop;
682 // Clean the url structure
683 themes.router.navigate( themes.router.baseUrl( '' ) );
685 // Restore scroll position
686 document.body.scrollTop = scroll;
688 // Return focus to the theme div
689 if ( themes.focusedTheme ) {
690 themes.focusedTheme.focus();
696 // Handles .disabled classes for next/previous buttons
697 navigation: function() {
699 // Disable Left/Right when at the start or end of the collection
700 if ( this.model.cid === this.model.collection.at(0).cid ) {
701 this.$el.find( '.left' ).addClass( 'disabled' );
703 if ( this.model.cid === this.model.collection.at( this.model.collection.length - 1 ).cid ) {
704 this.$el.find( '.right' ).addClass( 'disabled' );
708 // Performs the actions to effectively close
709 // the theme details overlay
710 closeOverlay: function() {
711 $( 'body' ).removeClass( 'modal-open' );
714 this.trigger( 'theme:collapse' );
717 // Confirmation dialog for deleting a theme
718 deleteTheme: function() {
719 return confirm( themes.data.settings.confirmDelete );
722 nextTheme: function() {
724 self.trigger( 'theme:next', self.model.cid );
728 previousTheme: function() {
730 self.trigger( 'theme:previous', self.model.cid );
734 // Checks if the theme screenshot is the old 300px width version
735 // and adds a corresponding class if it's true
736 screenshotCheck: function( el ) {
737 var screenshot, image;
739 screenshot = el.find( '.screenshot img' );
741 image.src = screenshot.attr( 'src' );
744 if ( image.width && image.width <= 300 ) {
745 el.addClass( 'small-screenshot' );
750 // Theme Preview view
751 // Set ups a modal overlay with the expanded theme data
752 themes.view.Preview = themes.view.Details.extend({
754 className: 'wp-full-overlay expanded',
755 el: '.theme-install-overlay',
758 'click .close-full-overlay': 'close',
759 'click .collapse-sidebar': 'collapse',
760 'click .previous-theme': 'previousTheme',
761 'click .next-theme': 'nextTheme',
765 // The HTML template for the theme preview
766 html: themes.template( 'theme-preview' ),
770 data = this.model.toJSON();
772 this.$el.removeClass( 'iframe-ready' ).html( this.html( data ) );
774 themes.router.navigate( themes.router.baseUrl( themes.router.themePath + this.model.get( 'id' ) ), { replace: true } );
776 this.$el.fadeIn( 200, function() {
777 $( 'body' ).addClass( 'theme-installer-active full-overlay-active' );
778 $( '.close-full-overlay' ).focus();
781 this.$el.find( 'iframe' ).one( 'load', function() {
786 iframeLoaded: function() {
787 this.$el.addClass( 'iframe-ready' );
791 this.$el.fadeOut( 200, function() {
792 $( 'body' ).removeClass( 'theme-installer-active full-overlay-active' );
794 // Return focus to the theme div
795 if ( themes.focusedTheme ) {
796 themes.focusedTheme.focus();
798 }).removeClass( 'iframe-ready' );
800 themes.router.navigate( themes.router.baseUrl( '' ) );
801 this.trigger( 'preview:close' );
802 this.undelegateEvents();
807 collapse: function( event ) {
808 var $button = $( event.currentTarget );
809 if ( 'true' === $button.attr( 'aria-expanded' ) ) {
810 $button.attr({ 'aria-expanded': 'false', 'aria-label': l10n.expandSidebar });
812 $button.attr({ 'aria-expanded': 'true', 'aria-label': l10n.collapseSidebar });
815 this.$el.toggleClass( 'collapsed' ).toggleClass( 'expanded' );
819 keyEvent: function( event ) {
820 // The escape key closes the preview
821 if ( event.keyCode === 27 ) {
822 this.undelegateEvents();
825 // The right arrow key, next theme
826 if ( event.keyCode === 39 ) {
827 _.once( this.nextTheme() );
830 // The left arrow key, previous theme
831 if ( event.keyCode === 37 ) {
832 this.previousTheme();
837 // Controls the rendering of div.themes,
838 // a wrapper that will hold all the theme elements
839 themes.view.Themes = wp.Backbone.View.extend({
842 $overlay: $( 'div.theme-overlay' ),
844 // Number to keep track of scroll position
845 // while in theme-overlay mode
848 // The theme count element
849 count: $( '.wp-core-ui .theme-count' ),
851 // The live themes count
854 initialize: function( options ) {
858 this.parent = options.parent;
860 // Set current view to [grid]
861 this.setView( 'grid' );
863 // Move the active theme to the beginning of the collection
866 // When the collection is updated by user input...
867 this.listenTo( self.collection, 'update', function() {
868 self.parent.page = 0;
873 // Update theme count to full result set when available.
874 this.listenTo( self.collection, 'query:success', function( count ) {
875 if ( _.isNumber( count ) ) {
876 self.count.text( count );
877 self.announceSearchResults( count );
879 self.count.text( self.collection.length );
880 self.announceSearchResults( self.collection.length );
884 this.listenTo( self.collection, 'query:empty', function() {
885 $( 'body' ).addClass( 'no-results' );
888 this.listenTo( this.parent, 'theme:scroll', function() {
889 self.renderThemes( self.parent.page );
892 this.listenTo( this.parent, 'theme:close', function() {
893 if ( self.overlay ) {
894 self.overlay.closeOverlay();
898 // Bind keyboard events.
899 $( 'body' ).on( 'keyup', function( event ) {
900 if ( ! self.overlay ) {
904 // Pressing the right arrow key fires a theme:next event
905 if ( event.keyCode === 39 ) {
906 self.overlay.nextTheme();
909 // Pressing the left arrow key fires a theme:previous event
910 if ( event.keyCode === 37 ) {
911 self.overlay.previousTheme();
914 // Pressing the escape key fires a theme:collapse event
915 if ( event.keyCode === 27 ) {
916 self.overlay.collapse( event );
921 // Manages rendering of theme pages
922 // and keeping theme count in sync
924 // Clear the DOM, please
927 // If the user doesn't have switch capabilities
928 // or there is only one theme in the collection
929 // render the detailed view of the active theme
930 if ( themes.data.themes.length === 1 ) {
932 // Constructs the view
933 this.singleTheme = new themes.view.Details({
934 model: this.collection.models[0]
937 // Render and apply a 'single-theme' class to our container
938 this.singleTheme.render();
939 this.$el.addClass( 'single-theme' );
940 this.$el.append( this.singleTheme.el );
943 // Generate the themes
944 // Using page instance
945 // While checking the collection has items
946 if ( this.options.collection.size() > 0 ) {
947 this.renderThemes( this.parent.page );
950 // Display a live theme count for the collection
951 this.liveThemeCount = this.collection.count ? this.collection.count : this.collection.length;
952 this.count.text( this.liveThemeCount );
954 this.announceSearchResults( this.liveThemeCount );
957 // Iterates through each instance of the collection
958 // and renders each theme module
959 renderThemes: function( page ) {
962 self.instance = self.collection.paginate( page );
964 // If we have no more themes bail
965 if ( self.instance.size() === 0 ) {
966 // Fire a no-more-themes event.
967 this.parent.trigger( 'theme:end' );
971 // Make sure the add-new stays at the end
972 if ( ! themes.isInstall && page >= 1 ) {
973 $( '.add-new-theme' ).remove();
976 // Loop through the themes and setup each theme view
977 self.instance.each( function( theme ) {
978 self.theme = new themes.view.Theme({
983 // Render the views...
985 // and append them to div.themes
986 self.$el.append( self.theme.el );
988 // Binds to theme:expand to show the modal box
989 // with the theme details
990 self.listenTo( self.theme, 'theme:expand', self.expand, self );
993 // 'Add new theme' element shown at the end of the grid
994 if ( ! themes.isInstall && themes.data.settings.canInstall ) {
995 this.$el.append( '<div class="theme add-new-theme"><a href="' + themes.data.settings.installURI + '"><div class="theme-screenshot"><span></span></div><h2 class="theme-name">' + l10n.addNew + '</h2></a></div>' );
1001 // Grabs current theme and puts it at the beginning of the collection
1002 currentTheme: function() {
1006 current = self.collection.findWhere({ active: true });
1008 // Move the active theme to the beginning of the collection
1010 self.collection.remove( current );
1011 self.collection.add( current, { at:0 } );
1015 // Sets current view
1016 setView: function( view ) {
1020 // Renders the overlay with the ThemeDetails view
1021 // Uses the current model data
1022 expand: function( id ) {
1025 // Set the current theme model
1026 this.model = self.collection.get( id );
1028 // Trigger a route update for the current model
1029 themes.router.navigate( themes.router.baseUrl( themes.router.themePath + this.model.id ) );
1031 // Sets this.view to 'detail'
1032 this.setView( 'detail' );
1033 $( 'body' ).addClass( 'modal-open' );
1035 // Set up the theme details view
1036 this.overlay = new themes.view.Details({
1040 this.overlay.render();
1041 this.$overlay.html( this.overlay.el );
1043 // Bind to theme:next and theme:previous
1044 // triggered by the arrow keys
1046 // Keep track of the current model so we
1047 // can infer an index position
1048 this.listenTo( this.overlay, 'theme:next', function() {
1049 // Renders the next theme on the overlay
1050 self.next( [ self.model.cid ] );
1053 .listenTo( this.overlay, 'theme:previous', function() {
1054 // Renders the previous theme on the overlay
1055 self.previous( [ self.model.cid ] );
1059 // This method renders the next theme on the overlay modal
1060 // based on the current position in the collection
1061 // @params [model cid]
1062 next: function( args ) {
1066 // Get the current theme
1067 model = self.collection.get( args[0] );
1068 // Find the next model within the collection
1069 nextModel = self.collection.at( self.collection.indexOf( model ) + 1 );
1071 // Sanity check which also serves as a boundary test
1072 if ( nextModel !== undefined ) {
1074 // We have a new theme...
1075 // Close the overlay
1076 this.overlay.closeOverlay();
1078 // Trigger a route update for the current model
1079 self.theme.trigger( 'theme:expand', nextModel.cid );
1084 // This method renders the previous theme on the overlay modal
1085 // based on the current position in the collection
1086 // @params [model cid]
1087 previous: function( args ) {
1089 model, previousModel;
1091 // Get the current theme
1092 model = self.collection.get( args[0] );
1093 // Find the previous model within the collection
1094 previousModel = self.collection.at( self.collection.indexOf( model ) - 1 );
1096 if ( previousModel !== undefined ) {
1098 // We have a new theme...
1099 // Close the overlay
1100 this.overlay.closeOverlay();
1102 // Trigger a route update for the current model
1103 self.theme.trigger( 'theme:expand', previousModel.cid );
1108 // Dispatch audible search results feedback message
1109 announceSearchResults: function( count ) {
1110 if ( 0 === count ) {
1111 wp.a11y.speak( l10n.noThemesFound );
1113 wp.a11y.speak( l10n.themesFound.replace( '%d', count ) );
1118 // Search input view controller.
1119 themes.view.Search = wp.Backbone.View.extend({
1122 className: 'wp-filter-search',
1123 id: 'wp-filter-search-input',
1127 placeholder: l10n.searchPlaceholder,
1129 'aria-describedby': 'live-search-desc'
1138 initialize: function( options ) {
1140 this.parent = options.parent;
1142 this.listenTo( this.parent, 'theme:close', function() {
1143 this.searching = false;
1148 search: function( event ) {
1150 if ( event.type === 'keyup' && event.which === 27 ) {
1151 event.target.value = '';
1155 * Since doSearch is debounced, it will only run when user input comes to a rest
1157 this.doSearch( event );
1160 // Runs a search on the theme collection.
1161 doSearch: _.debounce( function( event ) {
1164 this.collection.doSearch( event.target.value );
1166 // if search is initiated and key is not return
1167 if ( this.searching && event.which !== 13 ) {
1168 options.replace = true;
1170 this.searching = true;
1173 // Update the URL hash
1174 if ( event.target.value ) {
1175 themes.router.navigate( themes.router.baseUrl( themes.router.searchPath + event.target.value ), options );
1177 themes.router.navigate( themes.router.baseUrl( '' ) );
1181 pushState: function( event ) {
1182 var url = themes.router.baseUrl( '' );
1184 if ( event.target.value ) {
1185 url = themes.router.baseUrl( themes.router.searchPath + event.target.value );
1188 this.searching = false;
1189 themes.router.navigate( url );
1194 // Sets up the routes events for relevant url queries
1195 // Listens to [theme] and [search] params
1196 themes.Router = Backbone.Router.extend({
1199 'themes.php?theme=:slug': 'theme',
1200 'themes.php?search=:query': 'search',
1201 'themes.php?s=:query': 'search',
1202 'themes.php': 'themes',
1206 baseUrl: function( url ) {
1207 return 'themes.php' + url;
1210 themePath: '?theme=',
1211 searchPath: '?search=',
1213 search: function( query ) {
1214 $( '.wp-filter-search' ).val( query );
1217 themes: function() {
1218 $( '.wp-filter-search' ).val( '' );
1221 navigate: function() {
1222 if ( Backbone.history._hasPushState ) {
1223 Backbone.Router.prototype.navigate.apply( this, arguments );
1229 // Execute and setup the application
1232 // Initializes the blog's theme library view
1233 // Create a new collection with data
1234 this.themes = new themes.Collection( themes.data.themes );
1237 this.view = new themes.view.Appearance({
1238 collection: this.themes
1244 render: function() {
1250 Backbone.history.start({
1251 root: themes.data.settings.adminUrl,
1257 routes: function() {
1259 // Bind to our global thx object
1260 // so that the object is available to sub-views
1261 themes.router = new themes.Router();
1263 // Handles theme details route event
1264 themes.router.on( 'route:theme', function( slug ) {
1265 self.view.view.expand( slug );
1268 themes.router.on( 'route:themes', function() {
1269 self.themes.doSearch( '' );
1270 self.view.trigger( 'theme:close' );
1273 // Handles search route event
1274 themes.router.on( 'route:search', function() {
1275 $( '.wp-filter-search' ).trigger( 'keyup' );
1281 extraRoutes: function() {
1286 // Extend the main Search view
1287 themes.view.InstallerSearch = themes.view.Search.extend({
1294 // Handles Ajax request for searching through themes in public repo
1295 search: function( event ) {
1297 // Tabbing or reverse tabbing into the search input shouldn't trigger a search
1298 if ( event.type === 'keyup' && ( event.which === 9 || event.which === 16 ) ) {
1302 this.collection = this.options.parent.view.collection;
1305 if ( event.type === 'keyup' && event.which === 27 ) {
1306 event.target.value = '';
1309 this.doSearch( event.target.value );
1312 doSearch: _.debounce( function( value ) {
1315 request.search = value;
1317 // Intercept an [author] search.
1319 // If input value starts with `author:` send a request
1320 // for `author` instead of a regular `search`
1321 if ( value.substring( 0, 7 ) === 'author:' ) {
1322 request.search = '';
1323 request.author = value.slice( 7 );
1326 // Intercept a [tag] search.
1328 // If input value starts with `tag:` send a request
1329 // for `tag` instead of a regular `search`
1330 if ( value.substring( 0, 4 ) === 'tag:' ) {
1331 request.search = '';
1332 request.tag = [ value.slice( 4 ) ];
1335 $( '.filter-links li > a.current' ).removeClass( 'current' );
1336 $( 'body' ).removeClass( 'show-filters filters-applied show-favorites-form' );
1338 // Get the themes by sending Ajax POST request to api.wordpress.org/themes
1339 // or searching the local cache
1340 this.collection.query( request );
1343 themes.router.navigate( themes.router.baseUrl( themes.router.searchPath + value ), { replace: true } );
1347 themes.view.Installer = themes.view.Appearance.extend({
1349 el: '#wpbody-content .wrap',
1351 // Register events for sorting and filters in theme-navigation
1353 'click .filter-links li > a': 'onSort',
1354 'click .theme-filter': 'onFilter',
1355 'click .drawer-toggle': 'moreFilters',
1356 'click .filter-drawer .apply-filters': 'applyFilters',
1357 'click .filter-group [type="checkbox"]': 'addFilter',
1358 'click .filter-drawer .clear-filters': 'clearFilters',
1359 'click .filtered-by': 'backToFilters',
1360 'click .favorites-form-submit' : 'saveUsername',
1361 'keyup #wporg-username-input': 'saveUsername'
1364 // Initial render method
1365 render: function() {
1371 this.collection = new themes.Collection();
1373 // Bump `collection.currentQuery.page` and request more themes if we hit the end of the page.
1374 this.listenTo( this, 'theme:end', function() {
1376 // Make sure we are not already loading
1377 if ( self.collection.loadingThemes ) {
1381 // Set loadingThemes to true and bump page instance of currentQuery.
1382 self.collection.loadingThemes = true;
1383 self.collection.currentQuery.page++;
1385 // Use currentQuery.page to build the themes request.
1386 _.extend( self.collection.currentQuery.request, { page: self.collection.currentQuery.page } );
1387 self.collection.query( self.collection.currentQuery.request );
1390 this.listenTo( this.collection, 'query:success', function() {
1391 $( 'body' ).removeClass( 'loading-content' );
1392 $( '.theme-browser' ).find( 'div.error' ).remove();
1395 this.listenTo( this.collection, 'query:fail', function() {
1396 $( 'body' ).removeClass( 'loading-content' );
1397 $( '.theme-browser' ).find( 'div.error' ).remove();
1398 $( '.theme-browser' ).find( 'div.themes' ).before( '<div class="error"><p>' + l10n.error + '</p></div>' );
1405 // Set ups the view and passes the section argument
1406 this.view = new themes.view.Themes({
1407 collection: this.collection,
1411 // Reset pagination every time the install view handler is run
1414 // Render and append
1415 this.$el.find( '.themes' ).remove();
1417 this.$el.find( '.theme-browser' ).append( this.view.el ).addClass( 'rendered' );
1420 // Handles all the rendering of the public theme directory
1421 browse: function( section ) {
1422 // Create a new collection with the proper theme data
1424 this.collection.query( { browse: section } );
1427 // Sorting navigation
1428 onSort: function( event ) {
1429 var $el = $( event.target ),
1430 sort = $el.data( 'sort' );
1432 event.preventDefault();
1434 $( 'body' ).removeClass( 'filters-applied show-filters' );
1436 // Bail if this is already active
1437 if ( $el.hasClass( this.activeClass ) ) {
1443 // Trigger a router.naviagte update
1444 themes.router.navigate( themes.router.baseUrl( themes.router.browsePath + sort ) );
1447 sort: function( sort ) {
1450 $( '.filter-links li > a, .theme-filter' ).removeClass( this.activeClass );
1451 $( '[data-sort="' + sort + '"]' ).addClass( this.activeClass );
1453 if ( 'favorites' === sort ) {
1454 $ ( 'body' ).addClass( 'show-favorites-form' );
1456 $ ( 'body' ).removeClass( 'show-favorites-form' );
1459 this.browse( sort );
1463 onFilter: function( event ) {
1465 $el = $( event.target ),
1466 filter = $el.data( 'filter' );
1468 // Bail if this is already active
1469 if ( $el.hasClass( this.activeClass ) ) {
1473 $( '.filter-links li > a, .theme-section' ).removeClass( this.activeClass );
1474 $el.addClass( this.activeClass );
1480 // Construct the filter request
1481 // using the default values
1482 filter = _.union( filter, this.filtersChecked() );
1483 request = { tag: [ filter ] };
1485 // Get the themes by sending Ajax POST request to api.wordpress.org/themes
1486 // or searching the local cache
1487 this.collection.query( request );
1490 // Clicking on a checkbox to add another filter to the request
1491 addFilter: function() {
1492 this.filtersChecked();
1495 // Applying filters triggers a tag request
1496 applyFilters: function( event ) {
1498 tags = this.filtersChecked(),
1499 request = { tag: tags },
1500 filteringBy = $( '.filtered-by .tags' );
1503 event.preventDefault();
1506 $( 'body' ).addClass( 'filters-applied' );
1507 $( '.filter-links li > a.current' ).removeClass( 'current' );
1508 filteringBy.empty();
1510 _.each( tags, function( tag ) {
1511 name = $( 'label[for="filter-id-' + tag + '"]' ).text();
1512 filteringBy.append( '<span class="tag">' + name + '</span>' );
1515 // Get the themes by sending Ajax POST request to api.wordpress.org/themes
1516 // or searching the local cache
1517 this.collection.query( request );
1520 // Save the user's WordPress.org username and get his favorite themes.
1521 saveUsername: function ( event ) {
1522 var username = $( '#wporg-username-input' ).val(),
1523 request = { browse: 'favorites', user: username },
1527 event.preventDefault();
1530 // save username on enter
1531 if ( event.type === 'keyup' && event.which !== 13 ) {
1535 return wp.ajax.send( 'save-wporg-username', {
1539 success: function () {
1540 // Get the themes by sending Ajax POST request to api.wordpress.org/themes
1541 // or searching the local cache
1542 that.collection.query( request );
1547 // Get the checked filters
1548 // @return {array} of tags or false
1549 filtersChecked: function() {
1550 var items = $( '.filter-group' ).find( ':checkbox' ),
1553 _.each( items.filter( ':checked' ), function( item ) {
1554 tags.push( $( item ).prop( 'value' ) );
1557 // When no filters are checked, restore initial state and return
1558 if ( tags.length === 0 ) {
1559 $( '.filter-drawer .apply-filters' ).find( 'span' ).text( '' );
1560 $( '.filter-drawer .clear-filters' ).hide();
1561 $( 'body' ).removeClass( 'filters-applied' );
1565 $( '.filter-drawer .apply-filters' ).find( 'span' ).text( tags.length );
1566 $( '.filter-drawer .clear-filters' ).css( 'display', 'inline-block' );
1571 activeClass: 'current',
1573 // Overwrite search container class to append search
1575 searchContainer: $( '.wp-filter .search-form' ),
1577 uploader: function() {
1578 $( 'a.upload' ).on( 'click', function( event ) {
1579 event.preventDefault();
1580 $( 'body' ).addClass( 'show-upload-theme' );
1581 themes.router.navigate( themes.router.baseUrl( '?upload' ), { replace: true } );
1583 $( 'a.browse-themes' ).on( 'click', function( event ) {
1584 event.preventDefault();
1585 $( 'body' ).removeClass( 'show-upload-theme' );
1586 themes.router.navigate( themes.router.baseUrl( '' ), { replace: true } );
1590 // Toggle the full filters navigation
1591 moreFilters: function( event ) {
1592 event.preventDefault();
1594 if ( $( 'body' ).hasClass( 'filters-applied' ) ) {
1595 return this.backToFilters();
1598 // If the filters section is opened and filters are checked
1599 // run the relevant query collapsing to filtered-by state
1600 if ( $( 'body' ).hasClass( 'show-filters' ) && this.filtersChecked() ) {
1601 return this.addFilter();
1606 themes.router.navigate( themes.router.baseUrl( '' ) );
1607 $( 'body' ).toggleClass( 'show-filters' );
1610 // Clears all the checked filters
1611 // @uses filtersChecked()
1612 clearFilters: function( event ) {
1613 var items = $( '.filter-group' ).find( ':checkbox' ),
1616 event.preventDefault();
1618 _.each( items.filter( ':checked' ), function( item ) {
1619 $( item ).prop( 'checked', false );
1620 return self.filtersChecked();
1624 backToFilters: function( event ) {
1626 event.preventDefault();
1629 $( 'body' ).removeClass( 'filters-applied' );
1632 clearSearch: function() {
1633 $( '#wp-filter-search-input').val( '' );
1637 themes.InstallerRouter = Backbone.Router.extend({
1639 'theme-install.php?theme=:slug': 'preview',
1640 'theme-install.php?browse=:sort': 'sort',
1641 'theme-install.php?upload': 'upload',
1642 'theme-install.php?search=:query': 'search',
1643 'theme-install.php': 'sort'
1646 baseUrl: function( url ) {
1647 return 'theme-install.php' + url;
1650 themePath: '?theme=',
1651 browsePath: '?browse=',
1652 searchPath: '?search=',
1654 search: function( query ) {
1655 $( '.wp-filter-search' ).val( query );
1658 navigate: function() {
1659 if ( Backbone.history._hasPushState ) {
1660 Backbone.Router.prototype.navigate.apply( this, arguments );
1666 themes.RunInstaller = {
1670 // Passes the default 'section' as an option
1671 this.view = new themes.view.Installer({
1672 section: 'featured',
1673 SearchView: themes.view.InstallerSearch
1681 render: function() {
1687 Backbone.history.start({
1688 root: themes.data.settings.adminUrl,
1694 routes: function() {
1698 // Bind to our global `wp.themes` object
1699 // so that the router is available to sub-views
1700 themes.router = new themes.InstallerRouter();
1702 // Handles `theme` route event
1703 // Queries the API for the passed theme slug
1704 themes.router.on( 'route:preview', function( slug ) {
1705 request.theme = slug;
1706 self.view.collection.query( request );
1707 self.view.collection.once( 'update', function() {
1708 self.view.view.theme.preview();
1712 // Handles sorting / browsing routes
1713 // Also handles the root URL triggering a sort request
1714 // for `featured`, the default view
1715 themes.router.on( 'route:sort', function( sort ) {
1719 self.view.sort( sort );
1720 self.view.trigger( 'theme:close' );
1723 // Support the `upload` route by going straight to upload section
1724 themes.router.on( 'route:upload', function() {
1725 $( 'a.upload' ).trigger( 'click' );
1728 // The `search` route event. The router populates the input field.
1729 themes.router.on( 'route:search', function() {
1730 $( '.wp-filter-search' ).focus().trigger( 'keyup' );
1736 extraRoutes: function() {
1742 $( document ).ready(function() {
1743 if ( themes.isInstall ) {
1744 themes.RunInstaller.init();
1749 $( '.broken-themes .delete-theme' ).on( 'click', function() {
1750 return confirm( _wpThemeSettings.settings.confirmDelete );
1756 // Align theme browser thickbox
1758 jQuery(document).ready( function($) {
1759 tb_position = function() {
1760 var tbWindow = $('#TB_window'),
1761 width = $(window).width(),
1762 H = $(window).height(),
1763 W = ( 1040 < width ) ? 1040 : width,
1764 adminbar_height = 0;
1766 if ( $('#wpadminbar').length ) {
1767 adminbar_height = parseInt( $('#wpadminbar').css('height'), 10 );
1770 if ( tbWindow.size() ) {
1771 tbWindow.width( W - 50 ).height( H - 45 - adminbar_height );
1772 $('#TB_iframeContent').width( W - 50 ).height( H - 75 - adminbar_height );
1773 tbWindow.css({'margin-left': '-' + parseInt( ( ( W - 50 ) / 2 ), 10 ) + 'px'});
1774 if ( typeof document.body.style.maxWidth !== 'undefined' ) {
1775 tbWindow.css({'top': 20 + adminbar_height + 'px', 'margin-top': '0'});
1780 $(window).resize(function(){ tb_position(); });