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


Release history Release notifications

Download files

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

Files for djangocms-glyphicon-awesome, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size djangocms-glyphicon-awesome-0.1.0.tar.gz (143.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page