NP_AutoTwitter.php

The Shtick Auto-Twitter for Nucleus is a plugin designed for Nucleus CMS to enable automatic tweeting (messaging using the Twitter service) to announce when a user has posted a new blog item or even made a comment. (Tweets are posted to the Twitter account of the user who performed the action.)

General Plugin info
Author: Sean M. Cox
Current Version: 0.3.2
Download: Get the latest from the Auto Twitter web page. (.zip)

Server Requirements

  1. The Client URL (cURL) Library for PHP. (Most servers with PHP have this, but if there's a problem, this might be something to check into.)
  2. PHP sessions need to be enabled.
  3. OpenSSL

Upgrading

To upgrade The Shtick Auto-Twitter for Nucleus perform the following steps:

  1. Download the plugin's ZIP archive. (See link above.)
  2. Unzip the plugin to obtain the file, NP_AutoTwitter.php, and the folder, autotwitter.
  3. Copy NP_AutoTwitter.php and autotwitter to nucleus/plugins/ in your nucleus installation folder (on your webserver), overwriting the existing plugin file.
  4. Visit your Nucleus-managed website.
  5. Log in as an administrator.
  6. Visit the administrative console of your Nucleus-managed website.
  7. In the side-bar on the left-hand side of the screen, click on the “plugins” link. (This should bring up the Manage Plugins page.)
  8. Find the installed plugin in the list of plugins and click on the “edit options” link. (There should be only one option on the page that appears, with the value set to “No”.)
  9. Set the option's value to “Yes”.
  10. Click on the “Save Options” button.
  11. In the side-bar on the left-hand side of the screen, click on the “plugins” link. (This should bring up the Manage Plugins page.)
  12. Click on the “Update subscription list” button.

After performing these steps The Shtick Auto-Twitter for Nucleus should be upgraded.

Instructions also available from the website for The Shtick Auto-Twitter for Nucleus.

Installing

To install The Shtick Auto-Twitter for Nucleus perform the following steps:

  1. Download the plugin's ZIP archive. (See link above.)
  2. Unzip the plugin to obtain the file, NP_AutoTwitter.php, and the folder, autotwitter.
  3. Copy NP_AutoTwitter.php and autotwitter to nucleus/plugins/ in your nucleus installation folder (on your webserver).
  4. Visit your Nucleus-managed website.
  5. Log in as an administrator.
  6. Visit the administrative console of your Nucleus-managed website.
  7. In the side-bar on the left-hand side of the screen, click on the “plugins” link. (This should bring up the Manage Plugins page.)
  8. From the page that comes up, scroll down to the “Install New Plugin” section near the bottom.
  9. Select AutoTwitter from the drop-down menu in this section and then click on the “Install Plugin” button.

After performing these steps The Shtick Auto-Twitter for Nucleus should be installed. This can be verified by finding it in the list of installed plugins that begins at the top of the page. Instructions also available from the website for The Shtick Auto-Twitter for Nucleus.

How to use the plugin

The first thing one needs in order for a user to make use The Shtick Auto-Twitter for Nucleus, is a Twitter account. Once this basic necessity is provided for a user, the user needs to authorize The Shtick Auto-Twitter for Nucleus to post tweets to their account. This is done from the plugins page. The plugins page is available from the sidebar in the nucleus admin area. Once on this page, find the listing for The Shtick Auto-Twitter for Nucleus and click on the “admin” link for this plugin. This page provides a link which should be clicked on to take you to the Twitter website, where you will be asked to authorize the application.

Turning on Auto-Twittering.

Once tweeting has been authorized, a user can turn on and off auto-twittering on comments from their profile page. To turn on and off auto-twittering for blog entries, a blog administrator should visit the “settings” page for the blog. A checkbox is provided from the blog settings page to enable or disable auto-twittering.

Only bloggers who have authorized the plugin to tweet to their account will have tweets automatically posted.

Customization

The Shtick Auto-Twitter for Nucleus provides the ability to customize the format of tweets using tweet templates. The tweet template for comments can be specified in the user's profile page, whereas the blog entry tweet template can be specified in the blog settings page.

With the template, the text of the tweet is specified, and three wildcards can be used to make the tweets specific to the blog entry they relate to. The default tweet template for a blog comment is as follows:

Commented on %##BLOGNAME##% - %##URL##%

%##BLOGNAME##% and %##URL##% are both wildcards. There are three wildcards total. These wildcards, along with their replacements, are as follows.

  • %##BLOGNAME##% - The name of the blog.
  • %##TITLE##% - The title of the relevant item.
  • %##URL##% - The url of the relevant item.

Wishlist

  1. Allow a Twitter account for blogs (rather than just the users)
  2. Move the new item tweet option for users be specified under user settings.
  3. Have blog tweet option turn tweeting on and off for the blog account.

Bugs

History

  • Version 0.3.2, released 13/Sep/2011
  • Version 0.3.1, released 26/Oct/2010
  • Version 0.3, released 04/Oct/2010
  • Version 0.2, released 28/Jan/2010
  • Version 0.1, released 30/May/2009
autotwitter.txt · Last modified: 2011/09/14 03:31 (external edit)
 
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki