12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120 |
- /**
- * @output wp-admin/js/theme.js
- */
- /* global _wpThemeSettings, confirm, tb_position */
- window.wp = window.wp || {};
- ( function($) {
- // Set up our namespace...
- var themes, l10n;
- themes = wp.themes = wp.themes || {};
- // Store the theme data and settings for organized and quick access.
- // themes.data.settings, themes.data.themes, themes.data.l10n.
- themes.data = _wpThemeSettings;
- l10n = themes.data.l10n;
- // Shortcut for isInstall check.
- themes.isInstall = !! themes.data.settings.isInstall;
- // Setup app structure.
- _.extend( themes, { model: {}, view: {}, routes: {}, router: {}, template: wp.template });
- themes.Model = Backbone.Model.extend({
- // Adds attributes to the default data coming through the .org themes api.
- // Map `id` to `slug` for shared code.
- initialize: function() {
- var description;
- if ( this.get( 'slug' ) ) {
- // If the theme is already installed, set an attribute.
- if ( _.indexOf( themes.data.installedThemes, this.get( 'slug' ) ) !== -1 ) {
- this.set({ installed: true });
- }
- // If the theme is active, set an attribute.
- if ( themes.data.activeTheme === this.get( 'slug' ) ) {
- this.set({ active: true });
- }
- }
- // Set the attributes.
- this.set({
- // `slug` is for installation, `id` is for existing.
- id: this.get( 'slug' ) || this.get( 'id' )
- });
- // Map `section.description` to `description`
- // as the API sometimes returns it differently.
- if ( this.has( 'sections' ) ) {
- description = this.get( 'sections' ).description;
- this.set({ description: description });
- }
- }
- });
- // Main view controller for themes.php.
- // Unifies and renders all available views.
- themes.view.Appearance = wp.Backbone.View.extend({
- el: '#wpbody-content .wrap .theme-browser',
- window: $( window ),
- // Pagination instance.
- page: 0,
- // Sets up a throttler for binding to 'scroll'.
- initialize: function( options ) {
- // Scroller checks how far the scroll position is.
- _.bindAll( this, 'scroller' );
- this.SearchView = options.SearchView ? options.SearchView : themes.view.Search;
- // Bind to the scroll event and throttle
- // the results from this.scroller.
- this.window.on( 'scroll', _.throttle( this.scroller, 300 ) );
- },
- // Main render control.
- render: function() {
- // Setup the main theme view
- // with the current theme collection.
- this.view = new themes.view.Themes({
- collection: this.collection,
- parent: this
- });
- // Render search form.
- this.search();
- this.$el.removeClass( 'search-loading' );
- // Render and append.
- this.view.render();
- this.$el.empty().append( this.view.el ).addClass( 'rendered' );
- },
- // Defines search element container.
- searchContainer: $( '.search-form' ),
- // Search input and view
- // for current theme collection.
- search: function() {
- var view,
- self = this;
- // Don't render the search if there is only one theme.
- if ( themes.data.themes.length === 1 ) {
- return;
- }
- view = new this.SearchView({
- collection: self.collection,
- parent: this
- });
- self.SearchView = view;
- // Render and append after screen title.
- view.render();
- this.searchContainer
- .append( $.parseHTML( '<label class="screen-reader-text" for="wp-filter-search-input">' + l10n.search + '</label>' ) )
- .append( view.el )
- .on( 'submit', function( event ) {
- event.preventDefault();
- });
- },
- // Checks when the user gets close to the bottom
- // of the mage and triggers a theme:scroll event.
- scroller: function() {
- var self = this,
- bottom, threshold;
- bottom = this.window.scrollTop() + self.window.height();
- threshold = self.$el.offset().top + self.$el.outerHeight( false ) - self.window.height();
- threshold = Math.round( threshold * 0.9 );
- if ( bottom > threshold ) {
- this.trigger( 'theme:scroll' );
- }
- }
- });
- // Set up the Collection for our theme data.
- // @has 'id' 'name' 'screenshot' 'author' 'authorURI' 'version' 'active' ...
- themes.Collection = Backbone.Collection.extend({
- model: themes.Model,
- // Search terms.
- terms: '',
- // Controls searching on the current theme collection
- // and triggers an update event.
- doSearch: function( value ) {
- // Don't do anything if we've already done this search.
- // Useful because the Search handler fires multiple times per keystroke.
- if ( this.terms === value ) {
- return;
- }
- // Updates terms with the value passed.
- this.terms = value;
- // If we have terms, run a search...
- if ( this.terms.length > 0 ) {
- this.search( this.terms );
- }
- // If search is blank, show all themes.
- // Useful for resetting the views when you clean the input.
- if ( this.terms === '' ) {
- this.reset( themes.data.themes );
- $( 'body' ).removeClass( 'no-results' );
- }
- // Trigger a 'themes:update' event.
- this.trigger( 'themes:update' );
- },
- /**
- * Performs a search within the collection.
- *
- * @uses RegExp
- */
- search: function( term ) {
- var match, results, haystack, name, description, author;
- // Start with a full collection.
- this.reset( themes.data.themes, { silent: true } );
- // Trim the term.
- term = term.trim();
- // Escape the term string for RegExp meta characters.
- term = term.replace( /[-\/\\^$*+?.()|[\]{}]/g, '\\$&' );
- // Consider spaces as word delimiters and match the whole string
- // so matching terms can be combined.
- term = term.replace( / /g, ')(?=.*' );
- match = new RegExp( '^(?=.*' + term + ').+', 'i' );
- // Find results.
- // _.filter() and .test().
- results = this.filter( function( data ) {
- name = data.get( 'name' ).replace( /(<([^>]+)>)/ig, '' );
- description = data.get( 'description' ).replace( /(<([^>]+)>)/ig, '' );
- author = data.get( 'author' ).replace( /(<([^>]+)>)/ig, '' );
- haystack = _.union( [ name, data.get( 'id' ), description, author, data.get( 'tags' ) ] );
- if ( match.test( data.get( 'author' ) ) && term.length > 2 ) {
- data.set( 'displayAuthor', true );
- }
- return match.test( haystack );
- });
- if ( results.length === 0 ) {
- this.trigger( 'query:empty' );
- } else {
- $( 'body' ).removeClass( 'no-results' );
- }
- this.reset( results );
- },
- // Paginates the collection with a helper method
- // that slices the collection.
- paginate: function( instance ) {
- var collection = this;
- instance = instance || 0;
- // Themes per instance are set at 20.
- collection = _( collection.rest( 20 * instance ) );
- collection = _( collection.first( 20 ) );
- return collection;
- },
- count: false,
- /*
- * Handles requests for more themes and caches results.
- *
- *
- * When we are missing a cache object we fire an apiCall()
- * which triggers events of `query:success` or `query:fail`.
- */
- query: function( request ) {
- /**
- * @static
- * @type Array
- */
- var queries = this.queries,
- self = this,
- query, isPaginated, count;
- // Store current query request args
- // for later use with the event `theme:end`.
- this.currentQuery.request = request;
- // Search the query cache for matches.
- query = _.find( queries, function( query ) {
- return _.isEqual( query.request, request );
- });
- // If the request matches the stored currentQuery.request
- // it means we have a paginated request.
- isPaginated = _.has( request, 'page' );
- // Reset the internal api page counter for non-paginated queries.
- if ( ! isPaginated ) {
- this.currentQuery.page = 1;
- }
- // Otherwise, send a new API call and add it to the cache.
- if ( ! query && ! isPaginated ) {
- query = this.apiCall( request ).done( function( data ) {
- // Update the collection with the queried data.
- if ( data.themes ) {
- self.reset( data.themes );
- count = data.info.results;
- // Store the results and the query request.
- queries.push( { themes: data.themes, request: request, total: count } );
- }
- // Trigger a collection refresh event
- // and a `query:success` event with a `count` argument.
- self.trigger( 'themes:update' );
- self.trigger( 'query:success', count );
- if ( data.themes && data.themes.length === 0 ) {
- self.trigger( 'query:empty' );
- }
- }).fail( function() {
- self.trigger( 'query:fail' );
- });
- } else {
- // If it's a paginated request we need to fetch more themes...
- if ( isPaginated ) {
- return this.apiCall( request, isPaginated ).done( function( data ) {
- // Add the new themes to the current collection.
- // @todo Update counter.
- self.add( data.themes );
- self.trigger( 'query:success' );
- // We are done loading themes for now.
- self.loadingThemes = false;
- }).fail( function() {
- self.trigger( 'query:fail' );
- });
- }
- if ( query.themes.length === 0 ) {
- self.trigger( 'query:empty' );
- } else {
- $( 'body' ).removeClass( 'no-results' );
- }
- // Only trigger an update event since we already have the themes
- // on our cached object.
- if ( _.isNumber( query.total ) ) {
- this.count = query.total;
- }
- this.reset( query.themes );
- if ( ! query.total ) {
- this.count = this.length;
- }
- this.trigger( 'themes:update' );
- this.trigger( 'query:success', this.count );
- }
- },
- // Local cache array for API queries.
- queries: [],
- // Keep track of current query so we can handle pagination.
- currentQuery: {
- page: 1,
- request: {}
- },
- // Send request to api.wordpress.org/themes.
- apiCall: function( request, paginated ) {
- return wp.ajax.send( 'query-themes', {
- data: {
- // Request data.
- request: _.extend({
- per_page: 100
- }, request)
- },
- beforeSend: function() {
- if ( ! paginated ) {
- // Spin it.
- $( 'body' ).addClass( 'loading-content' ).removeClass( 'no-results' );
- }
- }
- });
- },
- // Static status controller for when we are loading themes.
- loadingThemes: false
- });
- // This is the view that controls each theme item
- // that will be displayed on the screen.
- themes.view.Theme = wp.Backbone.View.extend({
- // Wrap theme data on a div.theme element.
- className: 'theme',
- // Reflects which theme view we have.
- // 'grid' (default) or 'detail'.
- state: 'grid',
- // The HTML template for each element to be rendered.
- html: themes.template( 'theme' ),
- events: {
- 'click': themes.isInstall ? 'preview': 'expand',
- 'keydown': themes.isInstall ? 'preview': 'expand',
- 'touchend': themes.isInstall ? 'preview': 'expand',
- 'keyup': 'addFocus',
- 'touchmove': 'preventExpand',
- 'click .theme-install': 'installTheme',
- 'click .update-message': 'updateTheme'
- },
- touchDrag: false,
- initialize: function() {
- this.model.on( 'change', this.render, this );
- },
- render: function() {
- var data = this.model.toJSON();
- // Render themes using the html template.
- this.$el.html( this.html( data ) ).attr( 'data-slug', data.id );
- // Renders active theme styles.
- this.activeTheme();
- if ( this.model.get( 'displayAuthor' ) ) {
- this.$el.addClass( 'display-author' );
- }
- },
- // Adds a class to the currently active theme
- // and to the overlay in detailed view mode.
- activeTheme: function() {
- if ( this.model.get( 'active' ) ) {
- this.$el.addClass( 'active' );
- }
- },
- // Add class of focus to the theme we are focused on.
- addFocus: function() {
- var $themeToFocus = ( $( ':focus' ).hasClass( 'theme' ) ) ? $( ':focus' ) : $(':focus').parents('.theme');
- $('.theme.focus').removeClass('focus');
- $themeToFocus.addClass('focus');
- },
- // Single theme overlay screen.
- // It's shown when clicking a theme.
- expand: function( event ) {
- var self = this;
- event = event || window.event;
- // 'Enter' and 'Space' keys expand the details view when a theme is :focused.
- if ( event.type === 'keydown' && ( event.which !== 13 && event.which !== 32 ) ) {
- return;
- }
- // Bail if the user scrolled on a touch device.
- if ( this.touchDrag === true ) {
- return this.touchDrag = false;
- }
- // Prevent the modal from showing when the user clicks
- // one of the direct action buttons.
- if ( $( event.target ).is( '.theme-actions a' ) ) {
- return;
- }
- // Prevent the modal from showing when the user clicks one of the direct action buttons.
- if ( $( event.target ).is( '.theme-actions a, .update-message, .button-link, .notice-dismiss' ) ) {
- return;
- }
- // Set focused theme to current element.
- themes.focusedTheme = this.$el;
- this.trigger( 'theme:expand', self.model.cid );
- },
- preventExpand: function() {
- this.touchDrag = true;
- },
- preview: function( event ) {
- var self = this,
- current, preview;
- event = event || window.event;
- // Bail if the user scrolled on a touch device.
- if ( this.touchDrag === true ) {
- return this.touchDrag = false;
- }
- // Allow direct link path to installing a theme.
- if ( $( event.target ).not( '.install-theme-preview' ).parents( '.theme-actions' ).length ) {
- return;
- }
- // 'Enter' and 'Space' keys expand the details view when a theme is :focused.
- if ( event.type === 'keydown' && ( event.which !== 13 && event.which !== 32 ) ) {
- return;
- }
- // Pressing Enter while focused on the buttons shouldn't open the preview.
- if ( event.type === 'keydown' && event.which !== 13 && $( ':focus' ).hasClass( 'button' ) ) {
- return;
- }
- event.preventDefault();
- event = event || window.event;
- // Set focus to current theme.
- themes.focusedTheme = this.$el;
- // Construct a new Preview view.
- themes.preview = preview = new themes.view.Preview({
- model: this.model
- });
- // Render the view and append it.
- preview.render();
- this.setNavButtonsState();
- // Hide previous/next navigation if there is only one theme.
- if ( this.model.collection.length === 1 ) {
- preview.$el.addClass( 'no-navigation' );
- } else {
- preview.$el.removeClass( 'no-navigation' );
- }
- // Append preview.
- $( 'div.wrap' ).append( preview.el );
- // Listen to our preview object
- // for `theme:next` and `theme:previous` events.
- this.listenTo( preview, 'theme:next', function() {
- // Keep local track of current theme model.
- current = self.model;
- // If we have ventured away from current model update the current model position.
- if ( ! _.isUndefined( self.current ) ) {
- current = self.current;
- }
- // Get next theme model.
- self.current = self.model.collection.at( self.model.collection.indexOf( current ) + 1 );
- // If we have no more themes, bail.
- if ( _.isUndefined( self.current ) ) {
- self.options.parent.parent.trigger( 'theme:end' );
- return self.current = current;
- }
- preview.model = self.current;
- // Render and append.
- preview.render();
- this.setNavButtonsState();
- $( '.next-theme' ).trigger( 'focus' );
- })
- .listenTo( preview, 'theme:previous', function() {
- // Keep track of current theme model.
- current = self.model;
- // Bail early if we are at the beginning of the collection.
- if ( self.model.collection.indexOf( self.current ) === 0 ) {
- return;
- }
- // If we have ventured away from current model update the current model position.
- if ( ! _.isUndefined( self.current ) ) {
- current = self.current;
- }
- // Get previous theme model.
- self.current = self.model.collection.at( self.model.collection.indexOf( current ) - 1 );
- // If we have no more themes, bail.
- if ( _.isUndefined( self.current ) ) {
- return;
- }
- preview.model = self.current;
- // Render and append.
- preview.render();
- this.setNavButtonsState();
- $( '.previous-theme' ).trigger( 'focus' );
- });
- this.listenTo( preview, 'preview:close', function() {
- self.current = self.model;
- });
- },
- // Handles .disabled classes for previous/next buttons in theme installer preview.
- setNavButtonsState: function() {
- var $themeInstaller = $( '.theme-install-overlay' ),
- current = _.isUndefined( this.current ) ? this.model : this.current,
- previousThemeButton = $themeInstaller.find( '.previous-theme' ),
- nextThemeButton = $themeInstaller.find( '.next-theme' );
- // Disable previous at the zero position.
- if ( 0 === this.model.collection.indexOf( current ) ) {
- previousThemeButton
- .addClass( 'disabled' )
- .prop( 'disabled', true );
- nextThemeButton.trigger( 'focus' );
- }
- // Disable next if the next model is undefined.
- if ( _.isUndefined( this.model.collection.at( this.model.collection.indexOf( current ) + 1 ) ) ) {
- nextThemeButton
- .addClass( 'disabled' )
- .prop( 'disabled', true );
- previousThemeButton.trigger( 'focus' );
- }
- },
- installTheme: function( event ) {
- var _this = this;
- event.preventDefault();
- wp.updates.maybeRequestFilesystemCredentials( event );
- $( document ).on( 'wp-theme-install-success', function( event, response ) {
- if ( _this.model.get( 'id' ) === response.slug ) {
- _this.model.set( { 'installed': true } );
- }
- if ( response.blockTheme ) {
- _this.model.set( { 'block_theme': true } );
- }
- } );
- wp.updates.installTheme( {
- slug: $( event.target ).data( 'slug' )
- } );
- },
- updateTheme: function( event ) {
- var _this = this;
- if ( ! this.model.get( 'hasPackage' ) ) {
- return;
- }
- event.preventDefault();
- wp.updates.maybeRequestFilesystemCredentials( event );
- $( document ).on( 'wp-theme-update-success', function( event, response ) {
- _this.model.off( 'change', _this.render, _this );
- if ( _this.model.get( 'id' ) === response.slug ) {
- _this.model.set( {
- hasUpdate: false,
- version: response.newVersion
- } );
- }
- _this.model.on( 'change', _this.render, _this );
- } );
- wp.updates.updateTheme( {
- slug: $( event.target ).parents( 'div.theme' ).first().data( 'slug' )
- } );
- }
- });
- // Theme Details view.
- // Sets up a modal overlay with the expanded theme data.
- themes.view.Details = wp.Backbone.View.extend({
- // Wrap theme data on a div.theme element.
- className: 'theme-overlay',
- events: {
- 'click': 'collapse',
- 'click .delete-theme': 'deleteTheme',
- 'click .left': 'previousTheme',
- 'click .right': 'nextTheme',
- 'click #update-theme': 'updateTheme',
- 'click .toggle-auto-update': 'autoupdateState'
- },
- // The HTML template for the theme overlay.
- html: themes.template( 'theme-single' ),
- render: function() {
- var data = this.model.toJSON();
- this.$el.html( this.html( data ) );
- // Renders active theme styles.
- this.activeTheme();
- // Set up navigation events.
- this.navigation();
- // Checks screenshot size.
- this.screenshotCheck( this.$el );
- // Contain "tabbing" inside the overlay.
- this.containFocus( this.$el );
- },
- // Adds a class to the currently active theme
- // and to the overlay in detailed view mode.
- activeTheme: function() {
- // Check the model has the active property.
- this.$el.toggleClass( 'active', this.model.get( 'active' ) );
- },
- // Set initial focus and constrain tabbing within the theme browser modal.
- containFocus: function( $el ) {
- // Set initial focus on the primary action control.
- _.delay( function() {
- $( '.theme-overlay' ).trigger( 'focus' );
- }, 100 );
- // Constrain tabbing within the modal.
- $el.on( 'keydown.wp-themes', function( event ) {
- var $firstFocusable = $el.find( '.theme-header button:not(.disabled)' ).first(),
- $lastFocusable = $el.find( '.theme-actions a:visible' ).last();
- // Check for the Tab key.
- if ( 9 === event.which ) {
- if ( $firstFocusable[0] === event.target && event.shiftKey ) {
- $lastFocusable.trigger( 'focus' );
- event.preventDefault();
- } else if ( $lastFocusable[0] === event.target && ! event.shiftKey ) {
- $firstFocusable.trigger( 'focus' );
- event.preventDefault();
- }
- }
- });
- },
- // Single theme overlay screen.
- // It's shown when clicking a theme.
- collapse: function( event ) {
- var self = this,
- scroll;
- event = event || window.event;
- // Prevent collapsing detailed view when there is only one theme available.
- if ( themes.data.themes.length === 1 ) {
- return;
- }
- // Detect if the click is inside the overlay and don't close it
- // unless the target was the div.back button.
- if ( $( event.target ).is( '.theme-backdrop' ) || $( event.target ).is( '.close' ) || event.keyCode === 27 ) {
- // Add a temporary closing class while overlay fades out.
- $( 'body' ).addClass( 'closing-overlay' );
- // With a quick fade out animation.
- this.$el.fadeOut( 130, function() {
- // Clicking outside the modal box closes the overlay.
- $( 'body' ).removeClass( 'closing-overlay' );
- // Handle event cleanup.
- self.closeOverlay();
- // Get scroll position to avoid jumping to the top.
- scroll = document.body.scrollTop;
- // Clean the URL structure.
- themes.router.navigate( themes.router.baseUrl( '' ) );
- // Restore scroll position.
- document.body.scrollTop = scroll;
- // Return focus to the theme div.
- if ( themes.focusedTheme ) {
- themes.focusedTheme.find('.more-details').trigger( 'focus' );
- }
- });
- }
- },
- // Handles .disabled classes for next/previous buttons.
- navigation: function() {
- // Disable Left/Right when at the start or end of the collection.
- if ( this.model.cid === this.model.collection.at(0).cid ) {
- this.$el.find( '.left' )
- .addClass( 'disabled' )
- .prop( 'disabled', true );
- }
- if ( this.model.cid === this.model.collection.at( this.model.collection.length - 1 ).cid ) {
- this.$el.find( '.right' )
- .addClass( 'disabled' )
- .prop( 'disabled', true );
- }
- },
- // Performs the actions to effectively close
- // the theme details overlay.
- closeOverlay: function() {
- $( 'body' ).removeClass( 'modal-open' );
- this.remove();
- this.unbind();
- this.trigger( 'theme:collapse' );
- },
- // Set state of the auto-update settings link after it has been changed and saved.
- autoupdateState: function() {
- var callback,
- _this = this;
- // Support concurrent clicks in different Theme Details overlays.
- callback = function( event, data ) {
- var autoupdate;
- if ( _this.model.get( 'id' ) === data.asset ) {
- autoupdate = _this.model.get( 'autoupdate' );
- autoupdate.enabled = 'enable' === data.state;
- _this.model.set( { autoupdate: autoupdate } );
- $( document ).off( 'wp-auto-update-setting-changed', callback );
- }
- };
- // Triggered in updates.js
- $( document ).on( 'wp-auto-update-setting-changed', callback );
- },
- updateTheme: function( event ) {
- var _this = this;
- event.preventDefault();
- wp.updates.maybeRequestFilesystemCredentials( event );
- $( document ).on( 'wp-theme-update-success', function( event, response ) {
- if ( _this.model.get( 'id' ) === response.slug ) {
- _this.model.set( {
- hasUpdate: false,
- version: response.newVersion
- } );
- }
- _this.render();
- } );
- wp.updates.updateTheme( {
- slug: $( event.target ).data( 'slug' )
- } );
- },
- deleteTheme: function( event ) {
- var _this = this,
- _collection = _this.model.collection,
- _themes = themes;
- event.preventDefault();
- // Confirmation dialog for deleting a theme.
- if ( ! window.confirm( wp.themes.data.settings.confirmDelete ) ) {
- return;
- }
- wp.updates.maybeRequestFilesystemCredentials( event );
- $( document ).one( 'wp-theme-delete-success', function( event, response ) {
- _this.$el.find( '.close' ).trigger( 'click' );
- $( '[data-slug="' + response.slug + '"]' ).css( { backgroundColor:'#faafaa' } ).fadeOut( 350, function() {
- $( this ).remove();
- _themes.data.themes = _.without( _themes.data.themes, _.findWhere( _themes.data.themes, { id: response.slug } ) );
- $( '.wp-filter-search' ).val( '' );
- _collection.doSearch( '' );
- _collection.remove( _this.model );
- _collection.trigger( 'themes:update' );
- } );
- } );
- wp.updates.deleteTheme( {
- slug: this.model.get( 'id' )
- } );
- },
- nextTheme: function() {
- var self = this;
- self.trigger( 'theme:next', self.model.cid );
- return false;
- },
- previousTheme: function() {
- var self = this;
- self.trigger( 'theme:previous', self.model.cid );
- return false;
- },
- // Checks if the theme screenshot is the old 300px width version
- // and adds a corresponding class if it's true.
- screenshotCheck: function( el ) {
- var screenshot, image;
- screenshot = el.find( '.screenshot img' );
- image = new Image();
- image.src = screenshot.attr( 'src' );
- // Width check.
- if ( image.width && image.width <= 300 ) {
- el.addClass( 'small-screenshot' );
- }
- }
- });
- // Theme Preview view.
- // Sets up a modal overlay with the expanded theme data.
- themes.view.Preview = themes.view.Details.extend({
- className: 'wp-full-overlay expanded',
- el: '.theme-install-overlay',
- events: {
- 'click .close-full-overlay': 'close',
- 'click .collapse-sidebar': 'collapse',
- 'click .devices button': 'previewDevice',
- 'click .previous-theme': 'previousTheme',
- 'click .next-theme': 'nextTheme',
- 'keyup': 'keyEvent',
- 'click .theme-install': 'installTheme'
- },
- // The HTML template for the theme preview.
- html: themes.template( 'theme-preview' ),
- render: function() {
- var self = this,
- currentPreviewDevice,
- data = this.model.toJSON(),
- $body = $( document.body );
- $body.attr( 'aria-busy', 'true' );
- this.$el.removeClass( 'iframe-ready' ).html( this.html( data ) );
- currentPreviewDevice = this.$el.data( 'current-preview-device' );
- if ( currentPreviewDevice ) {
- self.tooglePreviewDeviceButtons( currentPreviewDevice );
- }
- themes.router.navigate( themes.router.baseUrl( themes.router.themePath + this.model.get( 'id' ) ), { replace: false } );
- this.$el.fadeIn( 200, function() {
- $body.addClass( 'theme-installer-active full-overlay-active' );
- });
- this.$el.find( 'iframe' ).one( 'load', function() {
- self.iframeLoaded();
- });
- },
- iframeLoaded: function() {
- this.$el.addClass( 'iframe-ready' );
- $( document.body ).attr( 'aria-busy', 'false' );
- },
- close: function() {
- this.$el.fadeOut( 200, function() {
- $( 'body' ).removeClass( 'theme-installer-active full-overlay-active' );
- // Return focus to the theme div.
- if ( themes.focusedTheme ) {
- themes.focusedTheme.find('.more-details').trigger( 'focus' );
- }
- }).removeClass( 'iframe-ready' );
- // Restore the previous browse tab if available.
- if ( themes.router.selectedTab ) {
- themes.router.navigate( themes.router.baseUrl( '?browse=' + themes.router.selectedTab ) );
- themes.router.selectedTab = false;
- } else {
- themes.router.navigate( themes.router.baseUrl( '' ) );
- }
- this.trigger( 'preview:close' );
- this.undelegateEvents();
- this.unbind();
- return false;
- },
- collapse: function( event ) {
- var $button = $( event.currentTarget );
- if ( 'true' === $button.attr( 'aria-expanded' ) ) {
- $button.attr({ 'aria-expanded': 'false', 'aria-label': l10n.expandSidebar });
- } else {
- $button.attr({ 'aria-expanded': 'true', 'aria-label': l10n.collapseSidebar });
- }
- this.$el.toggleClass( 'collapsed' ).toggleClass( 'expanded' );
- return false;
- },
- previewDevice: function( event ) {
- var device = $( event.currentTarget ).data( 'device' );
- this.$el
- .removeClass( 'preview-desktop preview-tablet preview-mobile' )
- .addClass( 'preview-' + device )
- .data( 'current-preview-device', device );
- this.tooglePreviewDeviceButtons( device );
- },
- tooglePreviewDeviceButtons: function( newDevice ) {
- var $devices = $( '.wp-full-overlay-footer .devices' );
- $devices.find( 'button' )
- .removeClass( 'active' )
- .attr( 'aria-pressed', false );
- $devices.find( 'button.preview-' + newDevice )
- .addClass( 'active' )
- .attr( 'aria-pressed', true );
- },
- keyEvent: function( event ) {
- // The escape key closes the preview.
- if ( event.keyCode === 27 ) {
- this.undelegateEvents();
- this.close();
- }
- // The right arrow key, next theme.
- if ( event.keyCode === 39 ) {
- _.once( this.nextTheme() );
- }
- // The left arrow key, previous theme.
- if ( event.keyCode === 37 ) {
- this.previousTheme();
- }
- },
- installTheme: function( event ) {
- var _this = this,
- $target = $( event.target );
- event.preventDefault();
- if ( $target.hasClass( 'disabled' ) ) {
- return;
- }
- wp.updates.maybeRequestFilesystemCredentials( event );
- $( document ).on( 'wp-theme-install-success', function() {
- _this.model.set( { 'installed': true } );
- } );
- wp.updates.installTheme( {
- slug: $target.data( 'slug' )
- } );
- }
- });
- // Controls the rendering of div.themes,
- // a wrapper that will hold all the theme elements.
- themes.view.Themes = wp.Backbone.View.extend({
- className: 'themes wp-clearfix',
- $overlay: $( 'div.theme-overlay' ),
- // Number to keep track of scroll position
- // while in theme-overlay mode.
- index: 0,
- // The theme count element.
- count: $( '.wrap .theme-count' ),
- // The live themes count.
- liveThemeCount: 0,
- initialize: function( options ) {
- var self = this;
- // Set up parent.
- this.parent = options.parent;
- // Set current view to [grid].
- this.setView( 'grid' );
- // Move the active theme to the beginning of the collection.
- self.currentTheme();
- // When the collection is updated by user input...
- this.listenTo( self.collection, 'themes:update', function() {
- self.parent.page = 0;
- self.currentTheme();
- self.render( this );
- } );
- // Update theme count to full result set when available.
- this.listenTo( self.collection, 'query:success', function( count ) {
- if ( _.isNumber( count ) ) {
- self.count.text( count );
- self.announceSearchResults( count );
- } else {
- self.count.text( self.collection.length );
- self.announceSearchResults( self.collection.length );
- }
- });
- this.listenTo( self.collection, 'query:empty', function() {
- $( 'body' ).addClass( 'no-results' );
- });
- this.listenTo( this.parent, 'theme:scroll', function() {
- self.renderThemes( self.parent.page );
- });
- this.listenTo( this.parent, 'theme:close', function() {
- if ( self.overlay ) {
- self.overlay.closeOverlay();
- }
- } );
- // Bind keyboard events.
- $( 'body' ).on( 'keyup', function( event ) {
- if ( ! self.overlay ) {
- return;
- }
- // Bail if the filesystem credentials dialog is shown.
- if ( $( '#request-filesystem-credentials-dialog' ).is( ':visible' ) ) {
- return;
- }
- // Pressing the right arrow key fires a theme:next event.
- if ( event.keyCode === 39 ) {
- self.overlay.nextTheme();
- }
- // Pressing the left arrow key fires a theme:previous event.
- if ( event.keyCode === 37 ) {
- self.overlay.previousTheme();
- }
- // Pressing the escape key fires a theme:collapse event.
- if ( event.keyCode === 27 ) {
- self.overlay.collapse( event );
- }
- });
- },
- // Manages rendering of theme pages
- // and keeping theme count in sync.
- render: function() {
- // Clear the DOM, please.
- this.$el.empty();
- // If the user doesn't have switch capabilities or there is only one theme
- // in the collection, render the detailed view of the active theme.
- if ( themes.data.themes.length === 1 ) {
- // Constructs the view.
- this.singleTheme = new themes.view.Details({
- model: this.collection.models[0]
- });
- // Render and apply a 'single-theme' class to our container.
- this.singleTheme.render();
- this.$el.addClass( 'single-theme' );
- this.$el.append( this.singleTheme.el );
- }
- // Generate the themes using page instance
- // while checking the collection has items.
- if ( this.options.collection.size() > 0 ) {
- this.renderThemes( this.parent.page );
- }
- // Display a live theme count for the collection.
- this.liveThemeCount = this.collection.count ? this.collection.count : this.collection.length;
- this.count.text( this.liveThemeCount );
- /*
- * In the theme installer the themes count is already announced
- * because `announceSearchResults` is called on `query:success`.
- */
- if ( ! themes.isInstall ) {
- this.announceSearchResults( this.liveThemeCount );
- }
- },
- // Iterates through each instance of the collection
- // and renders each theme module.
- renderThemes: function( page ) {
- var self = this;
- self.instance = self.collection.paginate( page );
- // If we have no more themes, bail.
- if ( self.instance.size() === 0 ) {
- // Fire a no-more-themes event.
- this.parent.trigger( 'theme:end' );
- return;
- }
- // Make sure the add-new stays at the end.
- if ( ! themes.isInstall && page >= 1 ) {
- $( '.add-new-theme' ).remove();
- }
- // Loop through the themes and setup each theme view.
- self.instance.each( function( theme ) {
- self.theme = new themes.view.Theme({
- model: theme,
- parent: self
- });
- // Render the views...
- self.theme.render();
- // ...and append them to div.themes.
- self.$el.append( self.theme.el );
- // Binds to theme:expand to show the modal box
- // with the theme details.
- self.listenTo( self.theme, 'theme:expand', self.expand, self );
- });
- // 'Add new theme' element shown at the end of the grid.
- if ( ! themes.isInstall && themes.data.settings.canInstall ) {
- 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>' );
- }
- this.parent.page++;
- },
- // Grabs current theme and puts it at the beginning of the collection.
- currentTheme: function() {
- var self = this,
- current;
- current = self.collection.findWhere({ active: true });
- // Move the active theme to the beginning of the collection.
- if ( current ) {
- self.collection.remove( current );
- self.collection.add( current, { at:0 } );
- }
- },
- // Sets current view.
- setView: function( view ) {
- return view;
- },
- // Renders the overlay with the ThemeDetails view.
- // Uses the current model data.
- expand: function( id ) {
- var self = this, $card, $modal;
- // Set the current theme model.
- this.model = self.collection.get( id );
- // Trigger a route update for the current model.
- themes.router.navigate( themes.router.baseUrl( themes.router.themePath + this.model.id ) );
- // Sets this.view to 'detail'.
- this.setView( 'detail' );
- $( 'body' ).addClass( 'modal-open' );
- // Set up the theme details view.
- this.overlay = new themes.view.Details({
- model: self.model
- });
- this.overlay.render();
- if ( this.model.get( 'hasUpdate' ) ) {
- $card = $( '[data-slug="' + this.model.id + '"]' );
- $modal = $( this.overlay.el );
- if ( $card.find( '.updating-message' ).length ) {
- $modal.find( '.notice-warning h3' ).remove();
- $modal.find( '.notice-warning' )
- .removeClass( 'notice-large' )
- .addClass( 'updating-message' )
- .find( 'p' ).text( wp.updates.l10n.updating );
- } else if ( $card.find( '.notice-error' ).length ) {
- $modal.find( '.notice-warning' ).remove();
- }
- }
- this.$overlay.html( this.overlay.el );
- // Bind to theme:next and theme:previous triggered by the arrow keys.
- // Keep track of the current model so we can infer an index position.
- this.listenTo( this.overlay, 'theme:next', function() {
- // Renders the next theme on the overlay.
- self.next( [ self.model.cid ] );
- })
- .listenTo( this.overlay, 'theme:previous', function() {
- // Renders the previous theme on the overlay.
- self.previous( [ self.model.cid ] );
- });
- },
- /*
- * This method renders the next theme on the overlay modal
- * based on the current position in the collection.
- *
- * @params [model cid]
- */
- next: function( args ) {
- var self = this,
- model, nextModel;
- // Get the current theme.
- model = self.collection.get( args[0] );
- // Find the next model within the collection.
- nextModel = self.collection.at( self.collection.indexOf( model ) + 1 );
- // Sanity check which also serves as a boundary test.
- if ( nextModel !== undefined ) {
- // We have a new theme...
- // Close the overlay.
- this.overlay.closeOverlay();
- // Trigger a route update for the current model.
- self.theme.trigger( 'theme:expand', nextModel.cid );
- }
- },
- /*
- * This method renders the previous theme on the overlay modal
- * based on the current position in the collection.
- *
- * @params [model cid]
- */
- previous: function( args ) {
- var self = this,
- model, previousModel;
- // Get the current theme.
- model = self.collection.get( args[0] );
- // Find the previous model within the collection.
- previousModel = self.collection.at( self.collection.indexOf( model ) - 1 );
- if ( previousModel !== undefined ) {
- // We have a new theme...
- // Close the overlay.
- this.overlay.closeOverlay();
- // Trigger a route update for the current model.
- self.theme.trigger( 'theme:expand', previousModel.cid );
- }
- },
- // Dispatch audible search results feedback message.
- announceSearchResults: function( count ) {
- if ( 0 === count ) {
- wp.a11y.speak( l10n.noThemesFound );
- } else {
- wp.a11y.speak( l10n.themesFound.replace( '%d', count ) );
- }
- }
- });
- // Search input view controller.
- themes.view.Search = wp.Backbone.View.extend({
- tagName: 'input',
- className: 'wp-filter-search',
- id: 'wp-filter-search-input',
- searching: false,
- attributes: {
- placeholder: l10n.searchPlaceholder,
- type: 'search',
- 'aria-describedby': 'live-search-desc'
- },
- events: {
- 'input': 'search',
- 'keyup': 'search',
- 'blur': 'pushState'
- },
- initialize: function( options ) {
- this.parent = options.parent;
- this.listenTo( this.parent, 'theme:close', function() {
- this.searching = false;
- } );
- },
- search: function( event ) {
- // Clear on escape.
- if ( event.type === 'keyup' && event.which === 27 ) {
- event.target.value = '';
- }
- // Since doSearch is debounced, it will only run when user input comes to a rest.
- this.doSearch( event );
- },
- // Runs a search on the theme collection.
- doSearch: function( event ) {
- var options = {};
- this.collection.doSearch( event.target.value.replace( /\+/g, ' ' ) );
- // if search is initiated and key is not return.
- if ( this.searching && event.which !== 13 ) {
- options.replace = true;
- } else {
- this.searching = true;
- }
- // Update the URL hash.
- if ( event.target.value ) {
- themes.router.navigate( themes.router.baseUrl( themes.router.searchPath + event.target.value ), options );
- } else {
- themes.router.navigate( themes.router.baseUrl( '' ) );
- }
- },
- pushState: function( event ) {
- var url = themes.router.baseUrl( '' );
- if ( event.target.value ) {
- url = themes.router.baseUrl( themes.router.searchPath + encodeURIComponent( event.target.value ) );
- }
- this.searching = false;
- themes.router.navigate( url );
- }
- });
- /**
- * Navigate router.
- *
- * @since 4.9.0
- *
- * @param {string} url - URL to navigate to.
- * @param {Object} state - State.
- * @return {void}
- */
- function navigateRouter( url, state ) {
- var router = this;
- if ( Backbone.history._hasPushState ) {
- Backbone.Router.prototype.navigate.call( router, url, state );
- }
- }
- // Sets up the routes events for relevant url queries.
- // Listens to [theme] and [search] params.
- themes.Router = Backbone.Router.extend({
- routes: {
- 'themes.php?theme=:slug': 'theme',
- 'themes.php?search=:query': 'search',
- 'themes.php?s=:query': 'search',
- 'themes.php': 'themes',
- '': 'themes'
- },
- baseUrl: function( url ) {
- return 'themes.php' + url;
- },
- themePath: '?theme=',
- searchPath: '?search=',
- search: function( query ) {
- $( '.wp-filter-search' ).val( query.replace( /\+/g, ' ' ) );
- },
- themes: function() {
- $( '.wp-filter-search' ).val( '' );
- },
- navigate: navigateRouter
- });
- // Execute and setup the application.
- themes.Run = {
- init: function() {
- // Initializes the blog's theme library view.
- // Create a new collection with data.
- this.themes = new themes.Collection( themes.data.themes );
- // Set up the view.
- this.view = new themes.view.Appearance({
- collection: this.themes
- });
- this.render();
- // Start debouncing user searches after Backbone.history.start().
- this.view.SearchView.doSearch = _.debounce( this.view.SearchView.doSearch, 500 );
- },
- render: function() {
- // Render results.
- this.view.render();
- this.routes();
- if ( Backbone.History.started ) {
- Backbone.history.stop();
- }
- Backbone.history.start({
- root: themes.data.settings.adminUrl,
- pushState: true,
- hashChange: false
- });
- },
- routes: function() {
- var self = this;
- // Bind to our global thx object
- // so that the object is available to sub-views.
- themes.router = new themes.Router();
- // Handles theme details route event.
- themes.router.on( 'route:theme', function( slug ) {
- self.view.view.expand( slug );
- });
- themes.router.on( 'route:themes', function() {
- self.themes.doSearch( '' );
- self.view.trigger( 'theme:close' );
- });
- // Handles search route event.
- themes.router.on( 'route:search', function() {
- $( '.wp-filter-search' ).trigger( 'keyup' );
- });
- this.extraRoutes();
- },
- extraRoutes: function() {
- return false;
- }
- };
- // Extend the main Search view.
- themes.view.InstallerSearch = themes.view.Search.extend({
- events: {
- 'input': 'search',
- 'keyup': 'search'
- },
- terms: '',
- // Handles Ajax request for searching through themes in public repo.
- search: function( event ) {
- // Tabbing or reverse tabbing into the search input shouldn't trigger a search.
- if ( event.type === 'keyup' && ( event.which === 9 || event.which === 16 ) ) {
- return;
- }
- this.collection = this.options.parent.view.collection;
- // Clear on escape.
- if ( event.type === 'keyup' && event.which === 27 ) {
- event.target.value = '';
- }
- this.doSearch( event.target.value );
- },
- doSearch: function( value ) {
- var request = {};
- // Don't do anything if the search terms haven't changed.
- if ( this.terms === value ) {
- return;
- }
- // Updates terms with the value passed.
- this.terms = value;
- request.search = value;
- /*
- * Intercept an [author] search.
- *
- * If input value starts with `author:` send a request
- * for `author` instead of a regular `search`.
- */
- if ( value.substring( 0, 7 ) === 'author:' ) {
- request.search = '';
- request.author = value.slice( 7 );
- }
- /*
- * Intercept a [tag] search.
- *
- * If input value starts with `tag:` send a request
- * for `tag` instead of a regular `search`.
- */
- if ( value.substring( 0, 4 ) === 'tag:' ) {
- request.search = '';
- request.tag = [ value.slice( 4 ) ];
- }
- $( '.filter-links li > a.current' )
- .removeClass( 'current' )
- .removeAttr( 'aria-current' );
- $( 'body' ).removeClass( 'show-filters filters-applied show-favorites-form' );
- $( '.drawer-toggle' ).attr( 'aria-expanded', 'false' );
- // Get the themes by sending Ajax POST request to api.wordpress.org/themes
- // or searching the local cache.
- this.collection.query( request );
- // Set route.
- themes.router.navigate( themes.router.baseUrl( themes.router.searchPath + encodeURIComponent( value ) ), { replace: true } );
- }
- });
- themes.view.Installer = themes.view.Appearance.extend({
- el: '#wpbody-content .wrap',
- // Register events for sorting and filters in theme-navigation.
- events: {
- 'click .filter-links li > a': 'onSort',
- 'click .theme-filter': 'onFilter',
- 'click .drawer-toggle': 'moreFilters',
- 'click .filter-drawer .apply-filters': 'applyFilters',
- 'click .filter-group [type="checkbox"]': 'addFilter',
- 'click .filter-drawer .clear-filters': 'clearFilters',
- 'click .edit-filters': 'backToFilters',
- 'click .favorites-form-submit' : 'saveUsername',
- 'keyup #wporg-username-input': 'saveUsername'
- },
- // Initial render method.
- render: function() {
- var self = this;
- this.search();
- this.uploader();
- this.collection = new themes.Collection();
- // Bump `collection.currentQuery.page` and request more themes if we hit the end of the page.
- this.listenTo( this, 'theme:end', function() {
- // Make sure we are not already loading.
- if ( self.collection.loadingThemes ) {
- return;
- }
- // Set loadingThemes to true and bump page instance of currentQuery.
- self.collection.loadingThemes = true;
- self.collection.currentQuery.page++;
- // Use currentQuery.page to build the themes request.
- _.extend( self.collection.currentQuery.request, { page: self.collection.currentQuery.page } );
- self.collection.query( self.collection.currentQuery.request );
- });
- this.listenTo( this.collection, 'query:success', function() {
- $( 'body' ).removeClass( 'loading-content' );
- $( '.theme-browser' ).find( 'div.error' ).remove();
- });
- this.listenTo( this.collection, 'query:fail', function() {
- $( 'body' ).removeClass( 'loading-content' );
- $( '.theme-browser' ).find( 'div.error' ).remove();
- $( '.theme-browser' ).find( 'div.themes' ).before( '<div class="error"><p>' + l10n.error + '</p><p><button class="button try-again">' + l10n.tryAgain + '</button></p></div>' );
- $( '.theme-browser .error .try-again' ).on( 'click', function( e ) {
- e.preventDefault();
- $( 'input.wp-filter-search' ).trigger( 'input' );
- } );
- });
- if ( this.view ) {
- this.view.remove();
- }
- // Sets up the view and passes the section argument.
- this.view = new themes.view.Themes({
- collection: this.collection,
- parent: this
- });
- // Reset pagination every time the install view handler is run.
- this.page = 0;
- // Render and append.
- this.$el.find( '.themes' ).remove();
- this.view.render();
- this.$el.find( '.theme-browser' ).append( this.view.el ).addClass( 'rendered' );
- },
- // Handles all the rendering of the public theme directory.
- browse: function( section ) {
- // Create a new collection with the proper theme data
- // for each section.
- if ( 'block-themes' === section ) {
- // Get the themes by sending Ajax POST request to api.wordpress.org/themes
- // or searching the local cache.
- this.collection.query( { tag: 'full-site-editing' } );
- } else {
- this.collection.query( { browse: section } );
- }
- },
- // Sorting navigation.
- onSort: function( event ) {
- var $el = $( event.target ),
- sort = $el.data( 'sort' );
- event.preventDefault();
- $( 'body' ).removeClass( 'filters-applied show-filters' );
- $( '.drawer-toggle' ).attr( 'aria-expanded', 'false' );
- // Bail if this is already active.
- if ( $el.hasClass( this.activeClass ) ) {
- return;
- }
- this.sort( sort );
- // Trigger a router.navigate update.
- themes.router.navigate( themes.router.baseUrl( themes.router.browsePath + sort ) );
- },
- sort: function( sort ) {
- this.clearSearch();
- // Track sorting so we can restore the correct tab when closing preview.
- themes.router.selectedTab = sort;
- $( '.filter-links li > a, .theme-filter' )
- .removeClass( this.activeClass )
- .removeAttr( 'aria-current' );
- $( '[data-sort="' + sort + '"]' )
- .addClass( this.activeClass )
- .attr( 'aria-current', 'page' );
- if ( 'favorites' === sort ) {
- $( 'body' ).addClass( 'show-favorites-form' );
- } else {
- $( 'body' ).removeClass( 'show-favorites-form' );
- }
- this.browse( sort );
- },
- // Filters and Tags.
- onFilter: function( event ) {
- var request,
- $el = $( event.target ),
- filter = $el.data( 'filter' );
- // Bail if this is already active.
- if ( $el.hasClass( this.activeClass ) ) {
- return;
- }
- $( '.filter-links li > a, .theme-section' )
- .removeClass( this.activeClass )
- .removeAttr( 'aria-current' );
- $el
- .addClass( this.activeClass )
- .attr( 'aria-current', 'page' );
- if ( ! filter ) {
- return;
- }
- // Construct the filter request
- // using the default values.
- filter = _.union( [ filter, this.filtersChecked() ] );
- request = { tag: [ filter ] };
- // Get the themes by sending Ajax POST request to api.wordpress.org/themes
- // or searching the local cache.
- this.collection.query( request );
- },
- // Clicking on a checkbox to add another filter to the request.
- addFilter: function() {
- this.filtersChecked();
- },
- // Applying filters triggers a tag request.
- applyFilters: function( event ) {
- var name,
- tags = this.filtersChecked(),
- request = { tag: tags },
- filteringBy = $( '.filtered-by .tags' );
- if ( event ) {
- event.preventDefault();
- }
- if ( ! tags ) {
- wp.a11y.speak( l10n.selectFeatureFilter );
- return;
- }
- $( 'body' ).addClass( 'filters-applied' );
- $( '.filter-links li > a.current' )
- .removeClass( 'current' )
- .removeAttr( 'aria-current' );
- filteringBy.empty();
- _.each( tags, function( tag ) {
- name = $( 'label[for="filter-id-' + tag + '"]' ).text();
- filteringBy.append( '<span class="tag">' + name + '</span>' );
- });
- // Get the themes by sending Ajax POST request to api.wordpress.org/themes
- // or searching the local cache.
- this.collection.query( request );
- },
- // Save the user's WordPress.org username and get his favorite themes.
- saveUsername: function ( event ) {
- var username = $( '#wporg-username-input' ).val(),
- nonce = $( '#wporg-username-nonce' ).val(),
- request = { browse: 'favorites', user: username },
- that = this;
- if ( event ) {
- event.preventDefault();
- }
- // Save username on enter.
- if ( event.type === 'keyup' && event.which !== 13 ) {
- return;
- }
- return wp.ajax.send( 'save-wporg-username', {
- data: {
- _wpnonce: nonce,
- username: username
- },
- success: function () {
- // Get the themes by sending Ajax POST request to api.wordpress.org/themes
- // or searching the local cache.
- that.collection.query( request );
- }
- } );
- },
- /**
- * Get the checked filters.
- *
- * @return {Array} of tags or false
- */
- filtersChecked: function() {
- var items = $( '.filter-group' ).find( ':checkbox' ),
- tags = [];
- _.each( items.filter( ':checked' ), function( item ) {
- tags.push( $( item ).prop( 'value' ) );
- });
- // When no filters are checked, restore initial state and return.
- if ( tags.length === 0 ) {
- $( '.filter-drawer .apply-filters' ).find( 'span' ).text( '' );
- $( '.filter-drawer .clear-filters' ).hide();
- $( 'body' ).removeClass( 'filters-applied' );
- return false;
- }
- $( '.filter-drawer .apply-filters' ).find( 'span' ).text( tags.length );
- $( '.filter-drawer .clear-filters' ).css( 'display', 'inline-block' );
- return tags;
- },
- activeClass: 'current',
- /**
- * When users press the "Upload Theme" button, show the upload form in place.
- */
- uploader: function() {
- var uploadViewToggle = $( '.upload-view-toggle' ),
- $body = $( document.body );
- uploadViewToggle.on( 'click', function() {
- // Toggle the upload view.
- $body.toggleClass( 'show-upload-view' );
- // Toggle the `aria-expanded` button attribute.
- uploadViewToggle.attr( 'aria-expanded', $body.hasClass( 'show-upload-view' ) );
- });
- },
- // Toggle the full filters navigation.
- moreFilters: function( event ) {
- var $body = $( 'body' ),
- $toggleButton = $( '.drawer-toggle' );
- event.preventDefault();
- if ( $body.hasClass( 'filters-applied' ) ) {
- return this.backToFilters();
- }
- this.clearSearch();
- themes.router.navigate( themes.router.baseUrl( '' ) );
- // Toggle the feature filters view.
- $body.toggleClass( 'show-filters' );
- // Toggle the `aria-expanded` button attribute.
- $toggleButton.attr( 'aria-expanded', $body.hasClass( 'show-filters' ) );
- },
- /**
- * Clears all the checked filters.
- *
- * @uses filtersChecked()
- */
- clearFilters: function( event ) {
- var items = $( '.filter-group' ).find( ':checkbox' ),
- self = this;
- event.preventDefault();
- _.each( items.filter( ':checked' ), function( item ) {
- $( item ).prop( 'checked', false );
- return self.filtersChecked();
- });
- },
- backToFilters: function( event ) {
- if ( event ) {
- event.preventDefault();
- }
- $( 'body' ).removeClass( 'filters-applied' );
- },
- clearSearch: function() {
- $( '#wp-filter-search-input').val( '' );
- }
- });
- themes.InstallerRouter = Backbone.Router.extend({
- routes: {
- 'theme-install.php?theme=:slug': 'preview',
- 'theme-install.php?browse=:sort': 'sort',
- 'theme-install.php?search=:query': 'search',
- 'theme-install.php': 'sort'
- },
- baseUrl: function( url ) {
- return 'theme-install.php' + url;
- },
- themePath: '?theme=',
- browsePath: '?browse=',
- searchPath: '?search=',
- search: function( query ) {
- $( '.wp-filter-search' ).val( query.replace( /\+/g, ' ' ) );
- },
- navigate: navigateRouter
- });
- themes.RunInstaller = {
- init: function() {
- // Set up the view.
- // Passes the default 'section' as an option.
- this.view = new themes.view.Installer({
- section: 'popular',
- SearchView: themes.view.InstallerSearch
- });
- // Render results.
- this.render();
- // Start debouncing user searches after Backbone.history.start().
- this.view.SearchView.doSearch = _.debounce( this.view.SearchView.doSearch, 500 );
- },
- render: function() {
- // Render results.
- this.view.render();
- this.routes();
- if ( Backbone.History.started ) {
- Backbone.history.stop();
- }
- Backbone.history.start({
- root: themes.data.settings.adminUrl,
- pushState: true,
- hashChange: false
- });
- },
- routes: function() {
- var self = this,
- request = {};
- // Bind to our global `wp.themes` object
- // so that the router is available to sub-views.
- themes.router = new themes.InstallerRouter();
- // Handles `theme` route event.
- // Queries the API for the passed theme slug.
- themes.router.on( 'route:preview', function( slug ) {
- // Remove existing handlers.
- if ( themes.preview ) {
- themes.preview.undelegateEvents();
- themes.preview.unbind();
- }
- // If the theme preview is active, set the current theme.
- if ( self.view.view.theme && self.view.view.theme.preview ) {
- self.view.view.theme.model = self.view.collection.findWhere( { 'slug': slug } );
- self.view.view.theme.preview();
- } else {
- // Select the theme by slug.
- request.theme = slug;
- self.view.collection.query( request );
- self.view.collection.trigger( 'update' );
- // Open the theme preview.
- self.view.collection.once( 'query:success', function() {
- $( 'div[data-slug="' + slug + '"]' ).trigger( 'click' );
- });
- }
- });
- /*
- * Handles sorting / browsing routes.
- * Also handles the root URL triggering a sort request
- * for `popular`, the default view.
- */
- themes.router.on( 'route:sort', function( sort ) {
- if ( ! sort ) {
- sort = 'popular';
- themes.router.navigate( themes.router.baseUrl( '?browse=popular' ), { replace: true } );
- }
- self.view.sort( sort );
- // Close the preview if open.
- if ( themes.preview ) {
- themes.preview.close();
- }
- });
- // The `search` route event. The router populates the input field.
- themes.router.on( 'route:search', function() {
- $( '.wp-filter-search' ).trigger( 'focus' ).trigger( 'keyup' );
- });
- this.extraRoutes();
- },
- extraRoutes: function() {
- return false;
- }
- };
- // Ready...
- $( function() {
- if ( themes.isInstall ) {
- themes.RunInstaller.init();
- } else {
- themes.Run.init();
- }
- // Update the return param just in time.
- $( document.body ).on( 'click', '.load-customize', function() {
- var link = $( this ), urlParser = document.createElement( 'a' );
- urlParser.href = link.prop( 'href' );
- urlParser.search = $.param( _.extend(
- wp.customize.utils.parseQueryString( urlParser.search.substr( 1 ) ),
- {
- 'return': window.location.href
- }
- ) );
- link.prop( 'href', urlParser.href );
- });
- $( '.broken-themes .delete-theme' ).on( 'click', function() {
- return confirm( _wpThemeSettings.settings.confirmDelete );
- });
- });
- })( jQuery );
- // Align theme browser thickbox.
- jQuery( function($) {
- window.tb_position = function() {
- var tbWindow = $('#TB_window'),
- width = $(window).width(),
- H = $(window).height(),
- W = ( 1040 < width ) ? 1040 : width,
- adminbar_height = 0;
- if ( $('#wpadminbar').length ) {
- adminbar_height = parseInt( $('#wpadminbar').css('height'), 10 );
- }
- if ( tbWindow.length >= 1 ) {
- tbWindow.width( W - 50 ).height( H - 45 - adminbar_height );
- $('#TB_iframeContent').width( W - 50 ).height( H - 75 - adminbar_height );
- tbWindow.css({'margin-left': '-' + parseInt( ( ( W - 50 ) / 2 ), 10 ) + 'px'});
- if ( typeof document.body.style.maxWidth !== 'undefined' ) {
- tbWindow.css({'top': 20 + adminbar_height + 'px', 'margin-top': '0'});
- }
- }
- };
- $(window).on( 'resize', function(){ tb_position(); });
- });
|