Tiny-Paper Extension

About

An extension by Aissac that adds Paperclipped based Tiny MCE support to Radiant CMS. This extension provides a Rich Text Editor filter and allows you to edit the content using the TinyMCE editor. It also provides an Image and File browser to help you manage the Paperclipped assets.

Tested on Radiant 0.7.1, 0.8 and 0.9 RC1.

Features

  • TinyMCE WYSIWYG editor in your Radiant page as a filter;
  • Image Browser, based on Paperclipped image assets;
  • File Browser, based on Paperclipped assets;
  • Upload assets directly in TinyMCE Image/File browser;
  • Thumbnails and text list views;
  • Directly add a link to a Radiant Page from TinyMce editor.

Installation

Tiny-Paper Extension has two dependencies, the Paperclipped extension and the will_paginate gem/plugin.

Install the Paperclipped Extension

1
2

git clone git://github.com/kbingman/paperclipped.git\
 vendor/extensions/paperclipped

And the will_paginate gem/plugin:

1
2

git clone git://github.com/mislav/will_paginate.git\
 vendor/plugins/will_paginate

or

1

sudo gem install mislav-will_paginate

You may also want to install the Settings Extension since it provides a very convenient way to configure thumbnail sizes for image assets:

1
2

git clone git://github.com/Squeegy/radiant-settings.git\
 vendor/extensions/settings

Finally, install the Tiny-Paper Extension

1
2

git clone git://github.com/Aissac/radiant-tiny-paper-extension.git\
 vendor/extensions/tiny_paper

For more information about installing and configuring Settings and Paperclipped check the extensions official pages.

If you choose to use the Settings extension, you will need to migrate it first:

1
2

rake radiant:extensions:settings:migrate
rake radiant:extensions:settings:update

and then run the Paperclipped migrations and updates:

1
2

rake radiant:extensions:paperclipped:migrate
rake radiant:extensions:paperclipped:update

The last step is to update the Tiny-Paper assets:

1

rake radiant:extensions:tiny_paper:update

Note

The git branches hold stable versions of the extension for older version of Radiant CMS. To checkout one of these branches:

1
2
3
4

git clone git://github.com/Aissac/radiant-tiny-paper-extension.git\
 vendor/extensions/tiny_paper
cd vendor/extensions/tiny_paper
git checkout -b <branch-name> origin/<remote-branch-name>

Usage

The Tiny-Paper Extension adds a “Rich Text Editor” filter, just toggle the filter and start using it.

It also provides two management systems, one for images and one for files, both based on Paperclipped.

The Image Browser can be accessed through the insert/edit image icon, and presents all the images uploaded through Paperclipped. There are two types of views (text list and thumbnails), filtering, sorting and pagination facilities, and a form for directly uploading images.

The File Browser can be accessed through the insert/edit link icon and has two sections: one for adding a link to a Radiant Page, and one for adding a link to an uploaded file.

Contributors