#WP-Nebula
The WP Nebula is a springboard WordPress theme for developers. Inspired by the HTML5 Boilerplate, this theme creates the framework for development. Like other WordPress startup themes, it has custom functionality built-in (like shortcodes, styles, and JS/PHP functions), but unlike other themes the WP Nebula is not meant for the end-user.
Wordpress developers will find all source code not obfuscated, so everything may be customized and altered to fit the needs of the project. Additional comments have been added to help explain what is happening; not only is this framework great for speedy development, but it is also useful for learning advanced WordPress techniques.
##Installation
To install, simply download the .zip, extract its contents, and upload to the /themes directory via FTP.
##Setup
- Activate theme
- Rename theme in style.css (and update necessary style.css metadata)
- Move .htaccess to root (or combine with existing)
- Install prompted plugins (as needed)
- General Settings
- Remove Tagline (Automated by initial activation)
- Timezone "New York", or appropriate timezone (Automated by initial activation)
- Week Starts On Sunday (Automated by initial activation)
- Reading Settings
- Front page displays "A static page" > Front page: "Home" (Automated by initial activation)
- Check "Discourage search engines from indexing this site" (Reading Settings)
- Permalinks Settings
- Select "Post name" (Automated by initial activation)
- Set (at least) Primary Menu (Appearance > Menus [Create a menu, then:] > Manage Locations)
- Modify logo.svg and logo.png
- Apple touch icon (129x129px) (Rounded corners and glossy effect are automatically applied.)
- Open Graph metadata in header.php (and remove comments)
- Open Graph thumbnails (Minimum Size: 560x560px with a 246px tall safezone in the center. Use og-temp.png as a template. Then delete from header.php!)
- Windows 8 Tiles
- 128x128px "tiny.png"
- 270x270px "square.png"
- 558x270px "wide.png"
- 517x516px "large.png"
- Google Analytics tracking number (functions.php)
- Strip out all unplanned HTML/CSS/JS (Do this before any other development! You can always add pieces back in from the Nebula.)
- [Theme development goes here]
- Specify styles for the WYSIWYG editor in style.css (as needed)
- Update screenshot.png (880x660px)
- Search for any remaining @TODO tags (use PHG Developer Info metabox on the Wordpress Dashboard)
- Testing
- Uncheck "Discourage search engines from indexing this site" (Reading Settings)
- Launch/Migration
- (If using Facebook SDK): Create Facebook app
- (If using Twitter Feed): Create Twitter app for domain, add API/access tokens to /includes/grabtweets.php, and swap "url:" parameter in /js/libs/twitter.js
- Enable W3 Total Cache
- Post-Launch testing
##Recommended Plugins When activated, WP Nebula will prompt to install the recommended and optional plugins. Following the instructions will install them all (or selected ones) at once. These can also be downloaded from Wordpress.org, or manually installed from the Wordpress Admin under the Plugins > Add New.
- Admin Menu Tree Page View
- Advanced Custom Fields
- Custom Post Type UI
- Contact Form 7
- Contact Form 7 DB
- Regenerate Thumbnails
- W3 Total Cache
- WP-PageNavi
##Optional Plugins
- Custom Facebook Feed
- Search Everything
- Smush.it
- Really Simple CAPTCHA
- Theme Check
- WooCommerce
- Wordpress SEO by Yoast
- WP Edit
##Included Libraries #####HTML/CSS
#####JavaScript
- bxSlider
- CSS Browser Selector
- DataTables
- DoubleTapToGo
- Gumby
- HTML5 Shiv
- jQuery
- jQuery UI
- Masked Input
- Mmenu
- Modernizr
- Respond
#####PHP
##Optional Libraries #####JavaScript
#####PHP
##Included API Integrations
- Facebook SDK for JavaScript
- Google Analytics (analytics.js)
- Google Maps API
- Twitter API
- Vimeo API
- Youtube Iframe API
- Youtube Data API
##Documentation
Documentation is available at http://gearside.com/nebula