13

We have a WordPress-based website that provides documentation to our REST API. Since our API is constantly changing, so is the documentation. However, we would like to keep the documentation version controlled so it can be matched against API commits. Is there a way to have WordPress pages get their content from a remote repository (GitHub, for example)? Or is there a way to push content to WordPress from some repository?

6

You already got something like this built in: Revisions.

// Define the nr of saved revisions in your wp-config.php
define( 'WP_POST_REVISIONS', 30 );

You can simply grab them by calling get_posts() with a post_type of revision.

To show the difference between two revisions simply use wp_text_diff().

// Example
$revisions = get_posts( array(
    'post_type' => 'revision'
) );
echo wp_text_diff(
     $revisions[0]['post_content']
    ,$revisions[1]['post_content']
    ,array(
         'title'       => 'Revision diff'
        ,'title_left'  => $revisions[0]['post_title']
        ,'title_right' => $revisions[1]['post_title']
     )
);

To diff for e.g. the last version with the version prior to the last, you could use end( $revisions )['post_content'] and diff it with $revisions[ count( $revisions ) -2 ]['post_content']. (Note: -2 as the arrays index start with zero and you want the version prior to the last.).

2
  • I like the idea of Revision. And there's a popular plugin WP Document Revisions can help managing revisions better. – Anh Tran Oct 31 '12 at 2:01
  • @Rilwis Should be an answer then :) – kaiser Oct 31 '12 at 2:10
5

You could use a Git hook and post per XML-RPC to WordPress. A Git hook can be any executable file, even PHP.

Another option – on GitHub – is to use the email hook: Go to https://github.com/username/projectname/admin/hooks, select Email and send an email to the blog. Enable the Post per email feature.

1
  • 2
    +1 Now we just need a combination of both features (built as solid plugin by the OP) :) – kaiser Oct 29 '12 at 19:07

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.