Module: CKEditor5::Rails::Presets::Concerns::PluginMethods

Included in:
Context::PresetBuilder, PresetBuilder
Defined in:
lib/ckeditor5/rails/presets/concerns/plugin_methods.rb

Instance Method Summary collapse

Instance Method Details

#external_plugin(name, **kwargs) ⇒ Object

Registers an external plugin loaded from a URL

Examples:

Load plugin from URL

external_plugin :MyPlugin, script: 'https://example.com/plugin.js'

Load with import alias

external_plugin :MyPlugin,
  script: 'https://example.com/plugin.js',
  import_as: 'Plugin'

Parameters:

  • name (Symbol) —

    Plugin name

  • kwargs (Hash) —

    Plugin options like :script, :import_as, :window_name, :stylesheets



30
31
32
 
# File 'lib/ckeditor5/rails/presets/concerns/plugin_methods.rb', line 30

def external_plugin(name, **kwargs)
  register_plugin(Editor::PropsExternalPlugin.new(name, **kwargs))
end

#inline_plugin(name, code) ⇒ Object

Registers an inline plugin with raw JavaScript code

Examples:

Define custom highlight plugin

inline_plugin :MyCustomPlugin, <<~JS
  import { Plugin } from 'ckeditor5';

  export default class MyCustomPlugin extends Plugin {
    static get pluginName() {
      return 'MyCustomPlugin';
    }

    init() {
      // Plugin initialization code
    }
  }
JS

Parameters:

  • name (Symbol) —

    Plugin name

  • code (String) —

    JavaScript code defining the plugin



52
53
54
 
# File 'lib/ckeditor5/rails/presets/concerns/plugin_methods.rb', line 52

def inline_plugin(name, code)
  register_plugin(Editor::PropsInlinePlugin.new(name, code))
end

#plugin(name, **kwargs) ⇒ Object

Register a single plugin by name

Examples:

Register standard plugin

plugin :Bold

Register premium plugin

plugin :RealTimeCollaboration, premium: true

Register custom plugin

plugin :MyPlugin, import_name: 'my-custom-plugin'

Parameters:

  • name (Symbol, Editor::PropsBasePlugin) —

    Plugin name or instance

  • kwargs (Hash) —

    Plugin configuration options



66
67
68
69
 
# File 'lib/ckeditor5/rails/presets/concerns/plugin_methods.rb', line 66

def plugin(name, **kwargs)
  premium(true) if kwargs[:premium] && respond_to?(:premium)
  register_plugin(PluginsBuilder.create_plugin(name, **kwargs))
end

#plugins(*names, **kwargs, &block) ⇒ Object

Register multiple plugins and configure plugin settings

Examples:

Register multiple plugins

plugins :Bold, :Italic, :Underline

Configure plugins with block

plugins do
  remove :Heading
  append :SelectAll, :RemoveFormat
  prepend :SourceEditing
end

Parameters:

  • names (Array<Symbol>) —

    Plugin names to register

  • kwargs (Hash) —

    Shared plugin configuration



83
84
85
86
87
88
89
90
91
 
# File 'lib/ckeditor5/rails/presets/concerns/plugin_methods.rb', line 83

def plugins(*names, **kwargs, &block)
  config[:plugins] ||= []

  names.each { |name| plugin(name, **kwargs) } unless names.empty?

  builder = PluginsBuilder.new(config[:plugins])
  builder.instance_eval(&block) if block_given?
  builder
end