README.textile
上传用户:netsea168
上传日期:2022-07-22
资源大小:4652k
文件大小:5k
源码类别:

Ajax

开发平台:

Others

  1. Easy CKEditor Rails plugin
  2. ===========================
  3. John Bradley
  4. http://johnmichaelbradley.com/
  5. This is my first foray into public Rails development, so please bear with me and help me out if you can. Thanks!
  6. I am going to leave Gaston's README intact for the most part, obvious changes excepted. The conversion process is done, now it's time to patch up the differences between
  7. FCK- and CKeditor.
  8. I've added basic support for a configuration YAML file (RAILS_ROOT/config/ckeditor.yml). It's very simple right now. This file is not entirely needed yet, but if
  9. you plan to use a file manager, you will need this to set file_manager_uri and _upload_uri. In all honesty, this won't work yet.
  10. ckeditor.yml example:
  11. development:
  12.   public_path: "#{path_to_your_public_directory}/uploads"
  13.   public_uri: '/uploads'
  14.   file_manager_uri: '/ckeditor/command'
  15.   file_manager_upload_uri: '/ckeditor/upload'
  16. production:
  17.   ...
  18. It should be noted that there are a lot of features from FCKeditor that either haven't been implemented in CKeditor yet or will never be implemented in CKeditor.
  19. Easy CKEditor Rails plugin
  20. ===========================
  21. **Gastón Ramos**
  22. ramos.gaston [at] gmail [dot] com
  23. http://gastonramos.wordpress.com/
  24. **Easy CKEditor is a Rails Plugin thats generate a WYSIWYG text editor helper**. This version is a fork of Scott Rutherford [great plugin](http://blog.caronsoftware.com/2007/11/16/Ckeditor-plugin-0-4-2-released) with a [EasyUpload plugin](http://martinezdelizarrondo.com/easyupload/) inlcuded of Alfonso Martínez de Lizarrondo.
  25. This plugin installs the CKeditor editor into your rails app, along with some helpers to use in your views.
  26. Features
  27. ========
  28. #--> John: more to come.
  29.    * WYSIWYG text editor helper.
  30. Versions
  31. ========
  32. This plugin is tested with:
  33.   * Rails 2.3
  34.   * Ruby 1.8.6 Patchlevel 287
  35.   * CKeditor 3.0
  36. Install
  37. =======
  38. If you got this using:
  39. ruby script/plugin install git://github.com/johnmichaelbradley/easy-ckeditor.git
  40. Then the install should of copied all the appropriate files to their homes. If you download a tar then you can either do
  41.   rake ckeditor:install
  42. from the root of your app, or the file will be installed the first time you startup after untaring the plugin.
  43. Uninstall
  44. =========
  45. Then the install should run task:
  46.   rake ckeditor:uninstall
  47. and all the installed files will be removed.
  48. Files
  49. =====
  50. Basically the whole of the CKeditor suite is copied to: public/javascripts/ckeditor
  51. There is a separate config file copied to: public/javascripts/ckcustom.js, that you can use to customize the install. This file is
  52. never overriden by upgrades or reinstalls. At the moment, public/javascripts/ckeditor/config.js symlinks to ckcustom.js.
  53. IMPORTANT
  54. =========
  55. #--> John: I have not tested whether or not this still applies with CKEditor.
  56. If you are hosting your rails app in a subdirectory you need to open:
  57.   public/javascripts/ckcustom.js
  58. and modify the CKRelativePath = ''; to suite your needs.
  59. For example if I have an app at www.mydomain.com/app/
  60. then the line should read:
  61.   CKRelativePath = '/app';
  62. Usage
  63. =====
  64. Basically include this in the page you wish to use the editor in
  65.   <%= javascript_include_tag :ckeditor %>
  66. Then instead of the normal textarea helper from Rails use this one
  67.   <%= ckeditor_textarea("object", "field", :width => '100%', :height => '200px') %>
  68. Thats it unless you are using AJAX
  69. AJAX
  70. ====
  71. #--> John: I have not tested AJAX functionality.
  72. To use a remote form you need to do something like this
  73.   <%= form_remote_tag :url => @options.merge(:controller => @scaffold_controller),
  74.                     :before => Ckeditor_before_js('note', 'text') %>
  75.     <%= ckeditor_textarea( "note", "text", :ajax => true ) %>
  76.   <%= end_form_tag %>
  77. If you forget to put in the :before it won't work, you can also use the Ckeditor_form_remote_tag described below
  78. Multiple Editors in a form
  79. ==========================
  80. To create a form using multiple editors use the Ckeditor_form_remote_tag helper and pass the :editors option. This takes an hash of model symbol keys with each having
  81. an array as its value. The array should contain the list of fields that will have editors attached to them.
  82.   <%= ckeditor_form_remote_tag :url => @options.merge(:controller => @scaffold_controller),
  83.                               :editors => { :multinote => ['text1', 'text2'] } %>
  84.     <%= ckeditor_textarea( "multinote", "text1", :ajax => true ) %>
  85.     <%= ckeditor_textarea( "multinote", "text2", :ajax => true ) %>
  86.   <%= end_form_tag %>
  87. There is also a ckeditor_remote_form_for version.
  88. Spell Check
  89. ===========
  90. CKEditor uses an online spellchecker provided by spellchecker.net.
  91. Contribute
  92. ==========
  93. #--> John: To discuss easy-ckeditor, report bugs, etc., please do so on GitHub:
  94. #--> http://github.com/johnmichaelbradley/easy-ckeditor/issues
  95. There is a lighthouseapp account if you want to send a patch or report a bug
  96. http://easy_Ckeditor.lighthouseapp.com/projects/27883-easy-Ckeditor/overview