Administrative and Maintenance Tools - Adding EditArea for Template & Plugin Editing

This isnt a Plugin or Mod, but a collection of code changes to allow the use of Edit Area to edit vbulletin templates and in the plugin code editor areas.

http://cdolivet.net/editarea/

Edit area
Here is EditArea, a free javascript editor for source code. (That is no way a WYSIWYG editor).
This editor is designed to edit souce code files in a textarea. The main goal is to allow text formatting, search and replace and real-time syntax highlight (for small text).

Download the zip file from the website above and unpack the zip file. Upload the edit_area folder into your /clientscript/ directory in your vbb installation. (See additional instructions at the bottom). You should now have a /clientscript/edit_area folder with files such as edit_area.css , edit_area.js and so on in it. Be sure that you also uploaded the images, langs, plugs and reg_syntax folders.


This requires changes to two files, one of them being optional.

The first file to edit is the includes/adminfunctions.php file
Using the UNMODIFIED 3.7.0 beta 2 version (Unsure of actual locations of the code in 3.6.8 and ealier versions, but the edits are basicly the same)

The first edit is adding the javascript to the page.
Open up the file includes/adminfunctions.php and look for the first

<script type=\"text/javascript\">

It should be around line 295.

Before that line, add

<script language=\"Javascript\" type=\"text/javascript\" src=\"../clientscript/edit_area/edit_area_full.js\"></script>

*Read http://cdolivet.net/editarea/editarea/docs/include.html for advanced options.

Now, we will look for the function print_textarea_row which starts around line 894

This is where the majority of the code changes are.

Comment out line 915 (add // infront of the line)

$resizer = "<div class=\"smallfont\"><a href=\"#\" $ie_reflow_css onclick=\"return resize_textarea(1, '{$vbulletin->textarea_id}')\">$vbphrase[increase_size]</a> <a href=\"#\" $ie_reflow_css onclick=\"return resize_textarea(-1, '{$vbulletin->textarea_id}')\">$vbphrase[decrease_size]</a></div>";

And then add the following code after the line you just commented out.

    if (!$doeditbutton OR strpos($name,'[') !== false)
    {
        $javascript_source = '';
    } else {
        $javascript_source = '
            <script language="Javascript" type="text/javascript">
                // initialisation
                editAreaLoader.init({
                    id: "'.$vbulletin->textarea_id.'"
                    ,language: "en"
                    ,syntax: "html"
                    ,start_highlight: true	
                    ,font_size: "8"
                    ,font_family: "verdana, monospace"
                    ,allow_resize: "both"
                    ,allow_toggle: true
                    ,replace_tab_by_spaces: 4
                    ,min_height: 350
                    ,syntax_selection_allow: "css,html,js,php,xml"
                    ,toolbar: " search, go_to_line,fullscreen, |, undo, redo, |, select_font,|, syntax_selection, |, change_smooth_selection, highlight, reset_highlight, |, help"
                });	
            </script>
        ';
    }

Please read up on http://cdolivet.net/editarea/editare...iguration.html to adjust some of the settings to your new editor interface

The last change in this file is a few lines down from the code you just pasted. Should be line 943.

Add

 $javascript_source.

to the begining of the following line

"<div id=\"ctrl_$name\"><textarea name=\"$name\" id=\"{$vbulletin->textarea_id}\"" . iif($textareaclass, " class=\"$textareaclass\"") . " rows=\"$rows\" cols=\"$cols\" wrap=\"virtual\" dir=\"$direction\" tabindex=\"1\"" . iif($vbulletin->debug, " title=\"name=&quot;$name&quot;\"") . ">" . iif($htmlise, htmlspecialchars_uni($value), $value) . "</textarea>$resizer</div>",

It should look like

 $javascript_source . "<div id=\"ctrl_$name\"> ...

Save and close this file!

Right now, the template editor usable and with a full screen option built into it, you shouldnt need a reason to use the Large Edit Box option. However, those changes are also quite easy to do so i will add those.

Open up the file admincp/textarea.php

On line 48,

opener.document.getElementsByName('<?php echo $vbulletin->GPC['name']; ?>')[0].value = textarea.value;

Change too

opener.document.getElementsByName('<?php echo $vbulletin->GPC['name']; ?>')[0].value = editAreaLoader.getValue("popuptextarea");

Before the closing </head> tag, add

<script language="Javascript" type="text/javascript" src="/clientscript/edit_area/edit_area_full.js"></script>

*Read http://cdolivet.net/editarea/editarea/docs/include.html for advanced options.

Replace the existing <body> tag (the entire line) with the following

<body onload="self.focus(); editAreaLoader.setValue('popuptextarea', opener.editAreaLoader.getValue('<?php echo $vbulletin->GPC['name']; ?>'));" style="margin:0px">
<script language="Javascript" type="text/javascript">
    // initialisation
    editAreaLoader.init({
        id: "popuptextarea"
        ,language: "en"
        ,syntax: "html"	
        ,start_highlight: true	
        ,font_size: "8"
        ,font_family: "verdana, monospace"
        ,allow_resize: "both"
        ,allow_toggle: true
        ,replace_tab_by_spaces: 4
        ,syntax_selection_allow: "css,html,js,php,xml"
        ,toolbar: " search, go_to_line, fullscreen, |, undo, redo, |, select_font,|, syntax_selection, |, change_smooth_selection, highlight, reset_highlight, |, help"
    });	
</script>

And you're done.


Some screenshots of the result..

**Note:
For whatever reason, you cannot save text from the Large Edit Box into the main window IF you have the Edit Area editor enabled! you MUST uncheck the Toggle Editor checkbox before clicking the Large Edit Box button. If you fail to do that, you may or may not save your changes and you may loose the textarea data all together.

For whatever reasons, while

editAreaLoader.setValue('popuptextarea', 
opener.editAreaLoader.getValue('<?php echo $vbulletin->GPC['name']; ?>'))

works, the reverse

opener.editAreaLoader.setValue('<?php echo $vbulletin->GPC['name']; ?>',
editAreaLoader.getValue('popuptextarea'));

does not, if anyone knows the secret to getting this to work, please post here!

---------------------------------------
**Addition
In the adminfunctions.php file, the line that we added that says

  ,syntax: "html"

change to

 ,syntax: "'.$syntax_type.'"

Before the line that reads

if (!$doeditbutton OR strpos($name,'[') !== false)

add

switch ($name) {
    case "installcode":
        $syntax_type = "php";
        break;
    case "uninstallcode":
        $syntax_type = "php";
        break;
    case "phpcode":
        $syntax_type = "php";
        break;
    case "template":
        $syntax_type = "html";
        break;
    default:
        $syntax_type = "html";
}

Anything in the template editor will default to HTML syntax, anything in the plugin section will default to PHP syntax and anywhere else, HTML syntax.

you can also add other lines here that could disable the javascript editor from showing, one example is adding

    case "searchstring":
        $doeditbutton = false;
        break;

before the default: line and this would disable the EditArea box. An alternative to searching and replacing text in many of the files.

you can also prevent the Large Area Button from being displayed by adding

$openwindowbutton = '<div style="width: 150px">&nbsp;</div>';

in whatever case statements you would like (i have it in the install/uninstall, phpcode and template editors along with the default selection).

[Triky]

Is there a search function?

[Snake]

Nice release!

[sweede]

Originally Posted by Triky

Is there a search function?

See my 3rd post.

[hocphp]

i will install . thank

[Wayne Luke]

Originally Posted by sweede

Click the binacular icon, if you're using IE though that stupid "scripted window" warning pops up and either refreshes your page or blows the world up or something like that. i hate that popup warning.

It can be turned off in the options. I do not get prompts for this. I can't remember which option does it though.

[gothicuser]

This walks on water, great and thanks.

One (major) problem for me is that it only fully works in M$ IE thingy
In FF it just displays the normal small edit box, and clicking on the 'Large Edit' opens the window and displays "False" (and nothing else) at the top of the window.

In Safari I get the full editor in the small window but again get the "False" in the large edit box.

p.s. I use FF on Linux and Safari on my Mac (where I do all my work)

[sweede]

Originally Posted by gothicuser

This walks on water, great and thanks.

One (major) problem for me is that it only fully works in M$ IE thingy
In FF it just displays the normal small edit box, and clicking on the 'Large Edit' opens the window and displays "False" (and nothing else) at the top of the window.

In Safari I get the full editor in the small window but again get the "False" in the large edit box.

p.s. I use FF on Linux and Safari on my Mac (where I do all my work)

Ya, the interaction between the normal in window (or parent) text area and when you click on the large edit box is a mess. It doesnt seem to want to communicate between the parent window (opener) and the new window both directions, I can only get it to work one way on IE.

I gave up on using the large edit box all together and used the fullscreen option in the normal parent window.

[gothicuser]

Oops. found that the Scriptblocker addon in FF was on steroids and over enthusiastically thought the editor was not nice. All working nicely (bar the Large Edit) But yes, full page will suffice

[KURTZ]

i think that this isn't ad add-on but a templates edit ...

[sweede]

Originally Posted by KURTZ

i think that this isn't ad add-on but a templates edit ...

It's a code modification, no templates are edited.