Skip to content

Latest commit

 

History

History
74 lines (47 loc) · 4.03 KB

README.markdown

File metadata and controls

74 lines (47 loc) · 4.03 KB

WordPress Theme Directory Slurper - Windows 10 Powershell edition

A command line Powershell script that downloads and updates a copy of the latest stable version of every theme in the WordPress.org theme repository.

Really handy for doing local searches across all WordPress themes.

Requirements

  • Windows with Powershell (only tested on Windows 10)
  • A command line SVN client. The one that comes with TortoiseSVN works.

Instructions

  1. Run Powershell
  2. cd WordPress-Theme-Directory-Slurper
  3. ./update.ps1

If you get a scripting error on the first run, then you need to enable local scripts to run without code signing. To do this run Powershell with Administrator permissions, and execute the command "Set-ExecutionPolicy RemoteSigned".

If you have downloaded the scripts using Internet Explorer or some other Microsoft product, then the script files may have their "internet" flag set, which means they won't run even with RemoteSigned. Since it is dangerous to enable arbitrary scripts to run without signing, I recommend not using Microsoft products to download the script, or alternatively copy/pasting the content of the script into a new text file which you can create yourself and rename accordingly, to eliminate the internet flag.

When the script is finished, the themes directory will contain all the themes. You can change which directories are used in the first three lines of the file.

FAQ

Why download the zip files? Why not use SVN?

An SVN checkout of the entire repository is a BEAST of a thing. Additionally, not all themes listed in the svn repositoriy are currently active.

Why not just do an SVN export of each themes's trunk?

There is no guarantee that the theme's trunk is the approved version. All themes must go through an approval process. Using the zip file gets around this as it uses the theme API to figure it all out and gives you the latest stable version

How long will it take?

Your first update will take a while. You'd be well-advised to let it run overnight. But subsequent updates are smart. The script tracks the SVN revision number of your latest update and then asks the Theme Trac install for a list of themes that have changed since. Only those changed themes are updated after the initial sync.

How much disk space do I need?

As of Summer 2017, the whole of the themes directory takes up about 7.5 GB. A small amount of additional space is needed for temporary ZIP file storage.

Something went wrong, how do I do a partial update?

The last successful update revision number is stored in themes/last-revision. You can just overwrite that and the next update will start after that revision.

What if I want Plugins instead of Themes?

Check out the WordPress-Plugin-Directory-Slurper.

Copyright & License

Copyright (C) 2017 Samuel Wood

Based on WordPress-Theme-Directory-Slurper which is Copyright (C) 2015 Aaron Jorbin which was itself based on WordPress-Plugin-Directory-Slurper which is Copyright (C) 2011 Mark Jaquith.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.