Post To Blog
------------

FEATURES

- Sends media files to your blog,
- Extracts information from your items to create the blog entry (for instance the title, tags...),
- Resizes pictures before sending them to your blog,
- Stores your blog details so you only need to type them once (your blog credentials will be encrypted)

1 - PREREQUISITES

You will need to have the following PERL modules installed: "XMLRPC::Lite".

If you have CPAN installed, then as the root user, simply run 'cpan', you should see a prompt:

cpan>

To install XMLRPC::Lite, type:

cpan> install XMLRPC::Lite [enter]


2 - How to install Post to Blog

Note: in the instructions below, replace ARCHIVEID with the name of your repository.

2a) copy post_to_blog-xx.tar.gz to your local repository directory (eg. /opt/eprints3/archives/ARCHIVEID/)

2b) extract files: tar zxvf post_to_blog-xx.tar.gz

2c) /opt/eprints3/bin/epadmin update_database_structure ARCHIVEID

2d) /opt/eprints3/bin/generate_static ARCHIVEID

2e) As the root user, restart the web server

3 - How to test?

The Post To Blog component is only available to items which have already been submitted. Once logged in to your repository, go to the Manage deposits screen and tick the option "Live Archive". This will display the items which you have already deposited. Next to each item will be two icons: one to view the item, one to post the item to a blog. Click on the latter icon.

A form will appear on the Screen asking you to fill in some information about your blog account: this includes:

- The Blog XMLRPC URL: this is usually of the form: "http://yourblogsite.com/xmlrpc.php"
- Your username and password

You can then enter a title, description for your blog entry and you may also tag your item. Finally choose a document to post to your blog and click 'Post'. If the post is successful, you will be redirected to the Manage deposits screen and a message will tell you the URL of your newly created blog entry.


