phile/twitter

Parse content and wrap Twitter mentions and hashtags

dev-master 2014-10-09 17:45 UTC

This package is auto-updated.

Last update: 2024-11-29 04:46:53 UTC


README

Parse content and wrap Twitter mentions and hashtags

Features

  • wrap @ mentions
  • wrap # tags
  • control output (title, target, class name)

1.1 Installation (composer)

php composer.phar require phile/twitter:*

1.2 Installation (Download)

  • Install Phile
  • Clone this repo into plugins/phile/twitter

2. Activation

After you have installed the plugin. You need to add the following line to your config.php file:

$config['plugins']['phile\\twitter'] = array('active' => true);
``

### Markdown Usage

All you have to do is use the `@` and `#` signs like you normally would in a tweet.

#### Basic Examples:

Put the code in there. Watch the HTML spew out.

```html
You can now mention twitter people like @james2doyle or even use hash tags like #philecms.

Output:

<p>You can now mention twitter people like <a target="_blank" class="twitter-link" title="@james2doyle" href="http://twitter.com/james2doyle">@james2doyle</a> or even use hash tags like <a target="_blank" class="twitter-link" title="#philecms" href="https://twitter.com/search?q=%23philecms&amp;src=hash">#philecms</a>.</p>

Config

Here are the settings. See the above output for where everything goes.

'class' => 'twitter-link', // class to apply to the a tag, false is off
'target' => '_blank', // target for the a tag, false is off
'title' => true, // show a title on the a tag, false is off

Why Use?

Clients are crazy. You want to make sure the HTML output is good and not a huge mess. It is a pretty good selling point for some people too. Doing things automagically always is.