WordPress Plugin Handbook Revision update

gistfile1.txt

Missing from the Plugin Handbook

These are notes of things from the new plugin handbook that are either currently missing or that need some serious updating.

Section 1 - Intro to Plugin Dev
How do plugins work
What is a plugin - Just sounds cheesy, and it is inaccurate on what a plugin needs. See 2. Plugin Basics

Section 2 - Plugin Basics
Activation/Deactivation hooks
Header Requirements - Should mention the license that is used when none is specified and link to the license page
Sanity Practices - what does this even mean?

Section 3 - Plugin Security
Intro needs rewritten to coincide with new sections
Data Validation
Sanitizing vs Escaping - Needs total refactoring. Some parts need moved to Data Validation. A clear line between Sanitizing and Escaping needs to be drawn

Section 4 - Hooks
Needs reading and refactoring

Section 5 - Menus
Nothing written yet

Section 6 - Shortcodes
Intro currently has all content. Needs sliced into sections and refactored

Section 7 - Settings
Intro currently contains all text. Intro needs to be written. Relevent text can be merged with other settings
Add Settings to Existing Page
Creating and Using Options
Custom Settings Page
Individual Options vs Array of Options
Settings API
Transients

Section 8 - Metadata
Create and Manage Post Metadata - Should flow with Creating Custom Meta Boxes

Section 9 - Custom Post Types and Taxonomies
Intro needs written
Registering Taxonomies needs completely rewritten
Working with Custom Post Type Data - More can be added
Working with Custom Taxonomies

Section 10 - Plugin Components
Was not originally part of the outline. These are extra things from the last HB

Section 11 - Users
Intro needs written
Need to also look into the User Permissions page from Section 3. Make sure they flow together
Creating and Managing users
Working with User Metadata

Section 12 - HTTP API
Needs fully written
See article at http://ben.lobaugh.net/blog/46117/wordpress-interacting-with-external-apis

Section 13 - Javascript, AJAX, jQuery
Needs rewritten and sections added
AJAX sidebar - This came from the old HB. Not sure what to do with it
Enqueuing properly

Section 14 - Cron
A fantastic article has already been written. Need to fit this into the other sections or change the new sections to match

Section 15 - Internationalization
Need to parcel out the intro sections into other sections
Creating Translation files
Functions for Translating
Understanding Internationalization

Section 16 - WordPress.org
Intro needs written
Releasing an Update
SVN Basics

Section 17 - Developer Tools
Intro needs written
Debug Bar and Add-Ons
Helper Plugins
References and Resources
Best Practices - Just a random set of links right now. Needs to be reviewed and probably totally rewritten