Joomla Extensions

CLUB

RokPadLatest Version: J1.5 1.8 / J2.5 1.2

RokPad
Joomla 1.5Joomla 2.5

Writing Joomla! Content never been this easy RokPad was devised as a tool to provide an easy and elegant interface for editing Joomla content, to make it a pleasure, not a chore. Advanced functions such as an Ajax saving action, plus shortcut keys, are some of the incredible time saving features.

RokPad is perfect for anyone who prefers to avoid the WYSIWYG editors but still craves the richness of a code editor.

NOTICE: This extensions is now available for Joomla 1.5 and Joomla 2.5
NOTICE: RokPad is not compatible with IE6.

Summary Features

  • Code Highlighter built on the great CodeMirror
  • Support for HTML, CSS, JavaScript, PHP, Mixed HTML (HTML + JS + CSS) and Mixed PHP (HTML + JS + CSS + PHP) syntax highlight
  • Ajax save and Automatic Save options. You'll never loose your content again, nor wait until the page has finished reloading after a save!
  • Save, Undo, Redo, Indentation, Goto line, Search, Search & Replace, HTML Tidy, Full Screen, Flash Settings like Tabs Unit, Tabs Mode, show/hide Lines number.
  • Statusbar showing the most important notifications
  • Keyboard shortcuts
  • Brackets match
  • Highlight of unclosed tags
  • And much more!
NOTICE: RokPad is NOT a WYSIWYG editor but rather a text / code editor with many advanced features such as syntax highlighting

Screenshots

RokPad

RokPad

RokPad

History

RokPad was created to meet the demands of the Team, a tool unrestricted by the limitations of the WYSIWYG editors, and something more advanced than simply using None. RokPad provides an medium for this, a balance between a useful interface and the unrestricted approach of code view. We at RocketTheme proudly build our content with RokPad.

Installation - Joomla 1.5


Downloading the Extension Files

  • RokPad Plugin (rokpad.zip) This file is the plugin package you will use to install RokPad into Joomla.

Using the Joomla Installer

From the Menu in your Joomla Administrator, go to Extensions → Install/Uninstall.

Next, browse for your rokpad.zip file you downloaded and then click Upload File & Install.


installation


Accessing the Plugins Page

Next, go to Extensions → Plugin Manager. From the list, find Editor - RokPad and open it to be brought to the RokPad Plugin Manager page, which lists all the available options for the plugin.


Set the RokPad as default Editor

Go to Site → Global Configuration. On the left, find Default WYSIWYG Editor and set the dropdown to Editor - RokPad. The same applies to individual users settings.


Requirements

RokPad has the following requirements in order to operate:-
  • Joomla 1.5.x / 1.6.x - ensure you are using the latest version
  • If you wish to use HTML Tidy: cURL is required, ensure you are using the latest version of cURL.
  • Compatible Browser: Internet Explorer 6 is not supported

Keyboard Shortcuts

If you are used to text editors, you will find the RokPad keyboards shortcut very useful. RokPad features many common keyboard shortcuts such as undo, redo, tab, shift+tab and even more below, in a list of featured keyboard shortcuts for both MacOSX and Windows/Linux:

MacOSX
  • Save: ⌘ S
  • Undo: ⌘ Z
  • Redo: ⌘ ⇧ Z
  • Auto Indent: CTRL-I
  • Goto Line: ⌘ L
  • Search: ⌥ F
Windows/Linux
  • Save: CTRL-S
  • Undo: CTRL-Z
  • Redo: CTRL-SHIFT-Z
  • Auto Indent: CTRL-I
  • Goto Line: CTRL-L
  • Search: ALT-F

Configuration

Below is a list of options that appear in Extensions → Plugin Manager → Editor - RokPad.

Parser: The type of parsing languages you want RokPad to use. You can select between:
  • XHTML
  • CSS
  • JavaScript
  • PHP
  • XHTML + CSS + JavaScript
  • XHTML + CSS + JavaScript + PHP
Initial Editor Height (px.): The initial height of the editor frame, given as pixels.

Coloring Pass Delay (ms.): Gives the amount of milliseconds between coloring passes.

Pass Time (ms.): Specifies the maximum amount of time that the highlighter will spend in one shot. Setting this too high will cause the editor to 'freeze' the browser for noticeable intervals.

Continuous Scan (ms.): Configure continuous scanning of the document. When 0, scanning is disabled. When set to a number, say N, a 'background' process will scan the document for passTime (see above) milliseconds every N milliseconds, regardless of whether anything has changed. This makes sure non-local changes propagate through the document, and will help keep everything consistent. It does add extra processing cost, even for an idle editor.

Auto Match Parens: When ON, will cause parens to be matched every time a key is pressed or the user clicks on the document. This refers to were there is a consistency between the opening and closing tag.

History Depth: Maximum length of the undo history.

History Delay (ms.): When nothing is done in the editor for this amount of milliseconds, pending changes get added to the undo history. Setting this lower will give the undo functionality a finer granularity.

Line Numbers: Show line numbers to the left of the editor.

Indent Unit (int.): An integer that specifies the amount of spaces one 'level' of indentation should add.

Tab Mode: Determines what the effect of pressing tab is.

Reindent On Load: When enabled, this causes the content of the editor to be reindented immediately when the editor loads.

Changelog

This is a non-exhaustive changelog for RokPad, inclusive of any alpha, beta, release candidate and final versions.

Joomla 1.5.x

Legend:
    
    * -> Security Fix
    # -> Bug Fix
    + -> Addition
    ^ -> Change
    - -> Removed
    ! -> Note
    
    ----------- 1.8 Release [15-Jul-2011] -----------
    
    15-Jul-2011 Djamil Legato
    # Issues Fixes for JEvents
    
    ----------- 1.7.2 Release [09-Feb-2011] -----------
    
    09-Feb-2011 Djamil Legato
    # Issues Fixes for ZOO
    
    ----------- 1.7.1 Release [09-Feb-2011] -----------
    
    09-Feb-2011 Djamil Legato
    # Issues Fixes for ZOO
    
    ----------- 1.7 Release [08-Feb-2011] -----------
    
    08-Feb-2011 Djamil Legato
    # Updated CodeMirror
    # Fixed CSS issues
    # Fixed issues with ZOO
    # Minor UI revamp for frontend
    
    ----------- 1.6 Release [01-Sep-2010] -----------
    
    01-Sep-2010 Djamil Legato
    # Fixed saving issue when editing on frontend.
    
    ----------- 1.5 Release [27-Aug-2010] -----------
    
    26-Aug-2010 Djamil Legato
    # Updated to CodeMirror v0.7
    
    ----------- 1.4 Release [22-Aug-2010] -----------
    
    22-Aug-2010 Djamil Legato
    # Fixed issue with editors names containing unallowed id characters
    # Added an apply/save fallback for AJAX saving in components like ZOO
    
    ----------- 1.3 Release [15-Jul-2010] -----------
    
    15-Jul-2010 Djamil Legato
    + MooTools 1.2 and Joomla 1.5.19 compatibility
    
    ----------- 1.2 Release [20-Mar-2010] -----------
    
    09-Apr-2010 Djamil Legato
    # Fixed IE issue with the built-in saving functionality that wasn't working properly.
    # Fixed IE full screen issues
    # Fixed resizing issues, now an overlay will appear when resizing in all browser rather than just Gecko
    
    -------------- 1.1 Release [17-Mar-2010] ----------
    
    17-Mar-2010 Djamil Legato
    ^ Updated the CodeMirror library to latest version (0.66)
    ^ Found a way to have the apply/save functionalities being more flexible so that can adapt to (hopefully) most of the 3rd party components (ie, Joom!Fish, sh404SEF, ...).
    # Manually fixed a core issue of CodeMirror that was causing infinite loops in certain circumstances (reported issue to the author).
    ^ Renamed some css names and made the css rules more restricted to avoid frontend templates conflicts.
    
    ------------- 1.0 Release [15-Jan-2010] -----------
    
    13-Jan-2010 Djamil Legato
    ^ Updated the CodeMirror library to latest version (0.65)
    + Added text-formatting functionality. A set of buttons that you can create/modify through an XML (can be found at plugins/editors/rokpad/text-formatter/buttons.xml). Text-formatting allows also to create your own set of custom shortcuts to be attached to the custom buttons.
    ^ Line Numbers and Text Wrapper are now separated. You can now choose to have one, the other, both or none. They are totally independent and now Line Numbers supports wrapped text as well.
    # Fixed several minor browsers specific issues (safari, internet explorer, opera)
    # Workaround for preventing apply and save not working on those components that are not firing the editor onSave method.
    ! This is a major release.
    
    ------------ 0.7 Release [27-Sep-2009] ------------
    
    27-Sep-2009 Brian Towles
    # Fixed missing Serializer dir
    + Added index.html to all dirs
    
    ------------ 0.6 Release [24-Sep-2009] ------------
    
    24-Sep-2009 Djamil Legato
    # Fixed duplication of items when autosave was enabled.
    
    ------------ 0.5 Release [31-Aug-2009] ------------
    
    31-Aug-2009 Djamil Legato
    # Fixed RokPad save not working on Joomla! pages with no Apply button.
    + Added options for having wrapped lines. You can now choose between wrapped lines or line numbers. The two can't be enabled at the same time.
    
    ------------ 0.4 Release [14-Aug-2009] ------------
    
    14-Aug-2009 Brian Towles
    # Fixed language install issue.
    # Fixed running htmlpurify under php4
    
    14-Aug-2009 Djamil Legato
    # Fixed + sign being dropped after tidying process
    + Undo is now enabled after tidying process
    
    ------------ 0.3 Release [12-Aug-2009] ------------
    
    12-Aug-2009 Djamil Legato
    # Fixed an issue on handling new custom modules created where the id and other infos weren't known yet.
    
    07-Aug-2009 Brian Towles
    ^ Moved to a build script and plugin layout.
    ^ Added i18n and language files.
    ^ Moved to the htmlawed as a tidy script.
    
    
    ------------ 0.2 Release [06-Aug-2009] ------------
    
    06-Aug-2009 Djamil Legato 
    # Fixed HTML Tidy failing when the content had amps.
    # Fixed z-indexing issue on Safari when RokPad in FullScreen mode.
    
    ------------ 0.1 Release [04-Aug-2009] ------------
    
    04-Aug-2009 Djamil Legato 
    ! Initial release.
    

Joomla 1.7.x

Legend:
    
    * -> Security Fix
    # -> Bug Fix
    + -> Addition
    ^ -> Change
    - -> Removed
    ! -> Note
    
    ----------- 1.1 Release [15-Jul-2011] -----------
    
    15-Jul-2011 Djamil Legato
    # Minor fixes and updates to the latest CodeMirror1
    
    ----------- 1.1 Release [13-Jun-2011] -----------
    
    08-Jun-2011 Djamil Legato
    # Fixed a JS error when using RokCandy
    
    ----------- 1.0 Release [01-Jun-2011] -----------
    
    02-Mar-2011
    ^ Updated to Joomla 1.6.x
    
    ----------- Initial Joomla 1.6.x. Changelog Creation -----------