I have a newly installed current instance of ckeditor.
The docs say, "The new toolbar utility, which you can find in your CKEditor distribution package, makes configuring an accessible toolbar a breeze. It is the most recommended way to set up the editor toolbar."
Where can I find this new toolbar utility? I don't see it anywhere.
Barring that, is there some more detailed documentation on what all the toolbar button settings are? I downloaded the "standard" set. In the config.js file in the toolbar settings it says there should be a "colors" item, but I don't see it.
Thanks,
doug
There is a note right above
There is a note right above this sentence which reads:
Which means the tool will be available in the next major release. Sorry for the confusion!
Documentation Manager, CKSource
See CKEditor 5 docs, CKEditor 4 docs, CKEditor 3 docs, CKFinder 3 docs, CKFinder 2 docs for help.
Visit the new CKEditor SDK for samples showcasing editor features to try out and download!
Ah. I see.
Ah. I see.
Any hints on configuring the toolbar meantime? I managed to comment out the spell checker (is there one around that is open source or at least less expensive?). Also, in the default config.js it seems to indicate there should be a "colors" button, but none is showing up. Mine looks like this right now, but I don't see how to find the details. This was from a standard installation. Actually, mine looks just like the toolbar here in these forums except I took out the spell checker. Not vital, but curious.
CKEDITOR.editorConfig = function( config ) {
// Define changes to default configuration here.
// For complete reference see:
// http://docs.ckeditor.com/#!/api/CKEDITOR.config
// The toolbar groups arrangement, optimized for two toolbar rows.
config.toolbarGroups = [
{ name: 'clipboard', groups: [ 'clipboard', 'undo' ] },
// { name: 'editing', groups: [ 'find', 'selection', 'spellchecker' ] },
{ name: 'editing', groups: [ 'find', 'selection' ] },
{ name: 'links' },
{ name: 'insert' },
{ name: 'forms' },
{ name: 'tools' },
{ name: 'document', groups: [ 'mode', 'document', 'doctools' ] },
{ name: 'others' },
'/',
{ name: 'basicstyles', groups: [ 'basicstyles', 'cleanup' ] },
{ name: 'paragraph', groups: [ 'list', 'indent', 'blocks', 'align', 'bidi' ] },
{ name: 'styles' },
{ name: 'colors' }
// { name: 'about' }
];
// Remove some buttons provided by the standard plugins, which are
// not needed in the Standard(s) toolbar.
config.removeButtons = 'Underline,Subscript,Superscript';
// Set the most common block elements.
config.format_tags = 'p;h1;h2;h3;pre';
// Simplify the dialog windows.
config.removeDialogTabs = 'image:advanced;link:advanced';
};
Thanks,
doug
If you open the /samples
If you open the /samples/plugins/toolbar/toolbar.html sample in your editor installation, it will give you a list of all toolbar items available in your particular editor package. If you want to drop something, just delete it (like: remove just the spell checker because your current method also removed the Find/Replace and Select All buttons which may not be what you actually wanted to achieve).
Better yet, if you know you don't want to use the default spell checker, create a custom build with CKBuilder (use the Standard preset, remove the WebSpellChecker and SpellCheckAsYouType plugins). In this way you won't be unneccessarily loading any plugins that you don't use. You can also add more plugins that you want to use through CKBuilder, but a word of warning here: don't add too many third-party plugins at the same time as some of them may have compatibility issues. This obviously does not apply to official CKSource plugins, including the optional ones, all of them are tested for each release and work together without issues.
Documentation Manager, CKSource
See CKEditor 5 docs, CKEditor 4 docs, CKEditor 3 docs, CKFinder 3 docs, CKFinder 2 docs for help.
Visit the new CKEditor SDK for samples showcasing editor features to try out and download!
Hi Anna,
Hi Anna,
Thanks for your reply.
I'll take a look at the /samples page you mentioned.
But I'm confused about a point you made. You said my current method also removed the Find/Replace and Select All buttons.
But what I did was (1) duplicate the line, (2) comment out the first line to keep for reference and (3) just deleted the spell checker from the duplicated line:
// { name: 'editing', groups: [ 'find', 'selection', 'spellchecker' ] },
{ name: 'editing', groups: [ 'find', 'selection' ] },
So shouldn't that just delete the spellchecker as you said?
In any case, there weren't Find/Replace or Select All buttons before or after my change.
That's part of what confuses me. There seem to be buttons mentioned in the standard config.js which aren't there. Another one is 'colors' - which doesn't appear on my ckeditor toolbar.
I think if I can clarify this confusion it would go a long way to helping figure out how to customize the toolbar.
Thanks very much for your help.
doug
Hi Doug,
Hi Doug,
sorry about the confusion, somehow I did not notice you commented out the line and then copied its modified version. You're right fo course.
As for the unused groups, I actually answered it already at Stack Overflow: http://stackoverflow.com/a/26797860/4226229
It is also explained in the documentation: http://docs.ckeditor.com/#!/guide/dev_toolbar-section-the-benefits-of-group-configuration
Documentation Manager, CKSource
See CKEditor 5 docs, CKEditor 4 docs, CKEditor 3 docs, CKFinder 3 docs, CKFinder 2 docs for help.
Visit the new CKEditor SDK for samples showcasing editor features to try out and download!
Hi Anna,
Hi Anna,
Thanks for the explanation. And also my apologies for the extra posting at Stack Overflow. I had previously posted a few questions in these forums and they never got responses, so I thought Stack Overflow might be the go-to place for ckeditor support. And then you come along and answer a bunch of my questions here today! :)
It seems from the documentation I've been reading it is advised to do as many settings inline as possible and avoid modifying config.js and other files which might be overwritten during a ckeditor upgrade. Does that sound right?
I am currently doing that for the actual editor configuration (the replace of the textarea) and for some other settings (getting rid of unwanted linebreaks). I wonder if I should also put these toolbar settings inline, in my forums source code, at the same point where I call the ckeditor to replace the textarea.
In other words, it seems that the best, recommended practice is to leave the ckeditor folder alone and do configurations outside of it for ease of upgrade. Is that correct?
On the other hand, if we add plugins that will be changing the ckeditor folder hierarchy anyway....
Thanks,
doug
Oh, one more thing. So why am
Oh, one more thing. So why am I not seeing the find and select-all buttons you mentioned? I notice they are not used here at these forums either. Is it because they are just there for later use if something which uses them is installed?
It's a bit hard to actually tell from looking at the configuration what buttons are supposed to actually be there or not.
doug