devot:eeDevoted to ExpressionEngine

Codeebird

***********************************************************************
THIS ADD-ON IS EFFECTIVELY ABANDONED AS I DON’T WORK WITH EXPRESSIONENGINE ANY MORE (APART FROM MAINTAINING OLD SITES).
***********************************************************************

An ExpressionEngine wrapper for the Codebird PHP Twitter library.

Copyright © 2014 Dan Herd @danherd http://danherd.net

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

Requirements

 
• ExpressionEngine 2
 
• PHP 5.3.0 or higher (Codebird requirement)
 
• OpenSSL extension (Codebird requirement)

1. Introduction

Really simple EE module that wraps the excellent Codebird PHP Twitter library. For more in-depth information on what calls are available, see the README file in that project, plus the Twitter API documentation.

2. Installation

Copy the codeebird folder into system/expressionengine/third_party and enable the module in the control panel.

3. Configuration

In the module settings, fill in your API key, API secret, access token and access secret. These will be stored in the database.

4. Usage

Usage pretty much matches up with the Codebird documentation; you just need to make your calls in an EE style. For example, to show the latest five (maximum) tweets from the authenticated user’s timeline, you could use the following in your template:

{exp:codeebird:statuses_homeTimeline include_rts=“1” count=“5”}
  {if no_results}<p>Nothing doing, kid!</p>{/if}
  <p>{text}</p>
{/exp:codeebird:statuses_homeTimeline}

To show a specific user’s last five (maximum) tweets, you could use the following:

{exp:codeebird:statuses_userTimeline screen_name=“danherd” include_rts=“1” count=“5”}
  {if no_results}<p>Nothing doing, kid!</p>{/if}
  <p>{text}</p>
{/exp:codeebird:statuses_userTimeline}

And so on.

As a bonus, if the result contains tweets (as in the two examples above), URLs, @mentions and #hashtags are automatically parsed into links. If the tweet contains images, the first one at medium size is stored in the {image} top level tag. Also, the created_at string is converted into a unix timestamp and returned as {timestamp}, so you can format it however you like using EE’s built-in functionality.

Issues and forks/pull-requests are always appreciated. Just read the CONTRIBUTING.md file before you start hacking away.