The Article Forge WordPress plugin aims to provide a capable facility to aid in the writing, publishing, and maintenance of hierarchical documents for the web. In particular are stories, articles, technical documents and periodicals that have titled sections.
Documents are organized such that the head consists of a title and summary (ie. abstract) describing the whole. Beneath this head are the various sections comprising the document with each section consisting of a heading and content. The entire document does not need to be assembled before publishing; sections can be published independently of each other.
Many useful features abound through out the editing interface. The main article edit screen provides a sortable ordered list of the sections with short-cuts to the section and a link to add new sections. Further, each document has display options that allow the author to customize the look and feel of the published article. These include:
- Display the Table of Contents on each page
- Display the Summary on each page
- Display the entire document on one page
CSS class tags are exposed for each div in the HTML content providing an easy means for users to specify their own style. In fact, users are encouraged to make their own copy of the css, js, and HTML under the content directory. An option is provided under the Settings page to specify the content directory from which files are served. All .css and .js files under the corresponding directories are automatically included in frontend Article Forge related pages.
The Article Forge plugin is unique in that the concepts of template and content are separated. Content is injected into the template instead of separate template files being required for each of the different post types, easing the burden on website maintainers. (See the Installation section for details.)
General commentary, upcoming features, and other WordPress related thought can be found at http://www.bytewisemcu.org/article/article-forge/.
Article Forge is simple to install and use with WordPress. The only requirement is a shift in perspective in how WordPress organizes and generates pages. The underlying engine for the Article Forge plugin makes a clear distinction between the concept of WordPress templates and that of generated content inside the themes displayable content area. Generally speaking, WordPress requires the site maintainer to create separate template pages for each custom post type under the themes template directory; not the plugin directory. These templates almost always leave the templates layout intact with changes made only in the content area. Seeking to provide a more practical and persistant approach, the Article Forge plugin provides a shared hook that generates the content for the template. In this way the user is not required to copy source html from the plugin directory and edit it.
There are various ways to utilize this feature with the simplest approach for those who wish to use Article Forge with other content types (this includes post and custom) is to do it the WordPress way.
* Copy single.php and archive.php located under your Themes working directory to single-articleforge_summary.php and archive-articleforge_summary.php respectively.
* Edit these files using the WP built-in editor under the Admin Appearance menu. Remove the existing post content generation area (usually denoted by