Knowledgebase: Pamela Functions
How do I configure the blogging module in Pamela?
Posted by - NA -, Last modified by on 19.08.2009 - 16:42

Pamela Blogging

The basic idea behind the Pamela blogging feature is that you setup your PC with Skype so that an incoming call can be recorded and automatically be published in your Blog. Alternatively you can also publish recorded calls (audio or video) or direct Pamela recordings to your Blog. The Pamela blogging feature makes it possible to create solutions like:

- Voicemail complaint boxes;

- Website voice remarks;

- Personal voicemail pages;

- Pure audio blogs;

- And many more things.

 

Requirements

To set this up on your system you need:

- Pamela for Skype – Professional Version,

- Skype;

- An FTP account on a FTP server;

- A Blog account on a Blog server;

- An internet connection.

 

 

Instructions

To setup the blogging feature in Pamela you need to do the following:

1. Go to 'Tools|Options';

2. Click on the 'Blogging' icon;

3. Click 'Enable Blogging';

4. Click 'Enable automatic Blogging';

5. Set the file size to for example 10 Mb;

6. Fill in the complete URL to the location where your mp3's will reside. Put this information in the 'Blog audio files base download URL’.

NOTE: This URL will replace the ‘--[BLOG_BASE_URL]--‘ placeholder of the Blog templates when published (see step 9 below).

7. Specify Blog application settings in the tab ‘Blogging service’

i. Check the ‘Publish blog immediately’ if you want to make the Blog entry you send available to the public immediately. If you leave this option unchecked your Blog entry will be stored in your Blog as a draft until you publish it at a later time.

ii. Click the checkbox ‘Enable audio files remote FTP storage and FTP uploading’ if you want to use remote storage and upload the mp3's automatically (see below).

8. Specify a Blogging Service to use in the tab ‘Blogging sevice’

Pamela Blogging module supports the most commonly used ways to interact remotely using XML-RPC. It acts as a client towards the Blog Server hosting your Blog. As any client it needs to know how and where to log on, and which interface to use.

i. Select an appropriate interface in ‘Blogging API’. The API to use is dependant on the Blog Service you use (see list of Blog Services tested below)

ii. Enter the complete URL to the location of your Blog Server API service in ‘Blog server connection URL’ (see list of sample URLs below).

iii. Set the 'Port'. The default is 80, if not using SSL.

iv. Check ‘Use secure (SSL) connection to blog server’ if your Blog Server has built in support for it.

v. Enter your credentials in ‘Username’ and ‘Password’. These are usually the same as the ones defined when you created the blog.

vi. Click on the ‘>’ button to the right of the ‘Blog ID’ drop down. This will use your settings and credentials to query the Blogging Service and fetch available publishing services. On success you may now select a Blog from the drop down. On failure, please review your Blogging Service settings and retry.

9. Leave the ‘Blog title template’ and ‘Blog content template’ tabs untouched.

If you decide to change the text being sent to your blog then please start by reading the following information.

‘Blog title’ and ‘Blog content’ is a template of the actual text being published on your Blog. You may leave the templates as default if you like.

Being templates, there are a few keywords and placeholders used that are interpreted by Pamela at time of sending the actual text to the Blog Server.

These are:

Placeholder Replaced by

--[BLOG_BASE_URL]-- The Content of the field 'Blog audio base download URL’

--[BLOG_FILE_NAME]-- File name of the mp3 sound file being published

--[CALL_PUBLISHED]-- Publishing date

--[CALL_RECEIVED]-- Mp3 sound file recording date

--[CALL_FILESIZE]-- File size of mp3 sound file being published

--[CALLER_FULLNAME]-- Full name of Skype Caller

--[CALLER_NICKNAME]-- Skype name/number of Skype Caller

 

Directives (on a line of it’s own)

--[#ifdef:keyword]-- If keyword is True (see below), then insert the block

 of text between here and corresponding

 #endif:keyword or #else:keyword, whichever comes first.

--[#else:keyword]-- If keyword in previous #ifdef:keyword is not True, then

 inserts the block of text between here and corresponding

 #endif:keyword.

--[#endif:keyword]-- Ends the block of text started by corresponding

 #ifdef:keyword or #else:keyword

 

Keyword Evaluates as

CALLER_NICKNAME True if the Skype name/number is available

CALL_VOICE_MAIL True if the mp3 file is a voice message

CALL_RECORD True if the mp3 file is a recorded call

CUSTOM_RECORD True if the mp3 file is a custom recording

10. Specify your FTP settings in the ‘Remote FTP storage’ tab if you want to use remote storage and upload the mp3's automatically.

(Make sure to enable the ‘Enable audio files remote FTP storage and FTP uploading’ checkbox in the ‘Blogging service’ tab as described above.)

i. Fill in the 'Remote blog voice files folder' where your recording will reside. Normally this starts with a forward slash and the folder name;

ii. In the FTP 'Server' field put the name of your FTP server or the IP address;

iii. Set the 'Port' to 21 (default);

iv. Fill the 'Username' field with the username for your FTP server;

v. Fill the 'Password' field with the password for your FTP server.

vi. Leave the ‘Use passive FTP mode’ option untouched (unless specifically required by your provider).

 

You are now ready to Blog a call, recording or custom recording. If someone calls and you have enabled 'Upload to FTP' the files will be published to your FTP server and other people can download and listen to the recordings as they read your blog.

You can also manually test the Blogging feature by right clicking a voice file in the main screen and select the ‘Blog this call’ command.

All entered FTP server data will remain saved by Pamela. So if you wish to keep your recording files locally while blogging, you only need to deactivate the ‘Enable audio files remote FTP storage and FTP uploading’ function.

NOTE: If you wish to hide Skype-Names/Numbers in the audio file name there is an option in the general settings to replace all of these with a custom string. This option is in the “General” options.

 

List of Blog Services tested with Pamela

This is a list of Blog Services that has currently been tested with Pamela. Please visit us on the Web for latest information.

Any actual implementation of a specific Blogging Service may differ in what they offer in terms of functionality. This may be due to authorization policy or to enhancements by add-ons installed. Please contact the Site Administrator of your Blogging Service if in doubt.

The Blogger API is one of the oldest Blogging APIs around. As such it is also among the most widespread APIs supported by existing Blog Servers, although sometimes with a twist. If your Blog Service is not listed in the below table there is a chance the Blogger API will work (just try it!).

Blog servers and API combinations tested:

Service Version Home Page APIs tested 

Blogger www.blogger.com Blogger

Wordpress  1.5.2 wordpress.org Blogger  metaWeblog

Livejournal www.livejournal.com Blogger1 LiveJournal 

Drupal 4.6.3 www.drupal.org Blogger metaWeblog

TypePad www.typepad.com Atom API

Textpattern2 4.0.1 www.textpattern.com metaWeblog 

Movable Type 3.2 www.movabletype.org Blogger

Radio Userland 8.0.8 radio.userland.com Blogger1 metaWeblog1

 

1) extended characters (UTF-8) not supported by the service

2) latest patches and plug-in XRT XML-RPC

 

 

Note on suggested template changes for Blogger.com 

You will not be able to see the title when you publish to Blogger.com without changing the Blog Content Template’ in Pamela for Skype. This is related to the way the Blogger.com interprets the title tags. Make following change to the beginning of the ‘Blog contents template’ in Pamela for Skype (you can translate the English words which are not between [ ] or < >):

<h3 class="post-title">

--[#ifdef:CALL_VOICE_MAIL]--

Pamela voice mail from --[CALLER_FULLNAME]-- received at --[CALL_RECEIVED]--

--[#endif:CALL_VOICE_MAIL]--

--[#ifdef:CALL_RECORD]--

Recorded call received from --[CALLER_FULLNAME]-- stored at --[CALL_RECEIVED]--

--[#endif:CALL_RECORD]—

--[#ifdef:CUSTOM_RECORD]--

User --[CALLER_FULLNAME]-- custom record stored at --[CALL_RECEIVED]--

--[#endif:CUSTOM_RECORD]--

</h3><p></p>

 

Unfortunately this workaround won't get rid of the title tag error in edit mode, but publishes the post as if it is ok, with the right look. You might still see an HTML error, but the blog is published correctly.

 

Blog service and typical Blog server API Connection URL:

Service Sample API Connection URL 

Blogger http://<blog server>/api

Wordpress  http://<blog server>/xmlrpc.php

Livejournal http://<blog server>/interface/blogger (Blogger API)

Livejournal http://<blog server>/interface/xmlrpc (LiveJournal API)

Drupal http://<blog server>/xmlrpc.php

TypePad http://<blog server>/t/atom/weblog

Textpattern http://<blog server>/xmlrpcs.php

Movable Type http://<blog server>/cgi-bin/mt/mt-xmlrpc.cgi

Radio Userland http://127.0.0.1/RPC2 (port: 5335)

 

Links for more information about what Blogging is about

Below you will find some links where you can find additional information about Blogging, the idea behind it, how you can use it, etc.

http://en.wikipedia.org/wiki/Blog (for a definition)

http://technorati.com/blogs (a directory of blogs by subject)

http://www.lights.com/weblogs (a weblog resource compendium)

Please also do an internet search on Blogging. You will find a lot of additional information.

(442 vote(s))
Helpful
Not helpful