Skip to main content

A plugin to incorporate Glyphicon and Font Awesome into djangocms-text-ckeditor

Project description

A django app that eases the incorporation of the two ckeditor plugins (http://ckeditor.com/addon/glyphicons and http://ckeditor.com/addon/fontawesome) into djangocms’s ckeditor.

Installation

To get started using djangocms-glyphicon-awesome:

  • install it with pip:

    $ pip install djangocms-glyphicon-awesome
  • add the app to INSTALLED_APPS and make sure it’s before djangocms_text_ckeditor:

    INSTALLED_APPS = (
        ...
        'djangocms_glyphicon_awesome',
        'djangocms_text_ckeditor',
        ...
    )

Configuration

You need a CKEDITOR_SETTINGS in settings.py that has toolbar_CMS attribute containing Glyphicons

You can copy the following configuration into your settings.py:

CKEDITOR_SETTINGS = {
    'language': '{{ language }}',
    'extraPlugins': 'cmsplugins,glyphicons,lineutils,widget',
    'toolbar_CMS': [
        [ 'Source', 'Maximize' ],
        [ 'cmsplugins', '-', 'ShowBlocks' ],
        [ 'Cut', 'Copy', 'Paste', 'PasteText', 'PasteFromWord', '-', 'Undo', 'Redo' ],
        [ 'Find', 'Replace', '-', 'SelectAll', '-', 'Scayt' ],
        [ 'Form', 'Checkbox', 'Radio', 'TextField', 'Textarea', 'Select', 'Button', 'ImageButton', 'HiddenField' ],
        [ 'Bold', 'Italic', 'Underline', 'Strike', 'Subscript', 'Superscript', '-', 'RemoveFormat' ],
        [ 'NumberedList', 'BulletedList', '-', 'Outdent', 'Indent', '-', 'Blockquote', 'CreateDiv', '-', 'JustifyLeft', 'JustifyCenter', 'JustifyRight', 'JustifyBlock', '-', 'BidiLtr', 'BidiRtl', 'Language' ],
        [ 'Link', 'Unlink', 'Anchor' ],
        [ 'Image', 'Flash', 'Table', 'HorizontalRule', 'Smiley', 'SpecialChar', 'PageBreak', 'Iframe' ],
        [ 'Styles', 'Format', 'Font', 'FontSize' ],
        [ 'TextColor', 'BGColor'],
        [ 'Glyphicons' ],
    ],
    'contentsCss': 'http://maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css',
    'skin': 'moono',
}

Now when you edit any text plugin with ckeditor, you will see a red cross button. Click the button and you will find all the Glyphicons.

Todo

Although the app’s name suggests that Font Awesome should be included in this app, it’s not done in the first release. Would add it in the future release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

djangocms-glyphicon-awesome-0.1.0.tar.gz (143.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page