formol 0.0.4

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 Florian DUTEY
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,147 @@
+# Formol
+
+Formol is a Rails 3.1 forum engine until Rails 3.2 is out for good.
+
+## Why an engine?
+
+Because I needed it. And because a forum is rarely a standalone app in a professional context.
+
+In a near future, formol engine will be packaged in an independent and standalone application for those who need it.
+
+## Why writing a forum in rails?
+
+Customers often ask for a forum inside their app. They think about phpBB or vBulletin like forum but it doesn't exist in rails.
+Developping one is really too expensive for a single project and:
+
+* bridge users between a phpBB and a rails app is very tricky (I just don't wanna try it).
+* phpBB / vBulletin is hard (or impossible) to embed into an application layout, especially a rails one.
+* Rails app and php forum won't share their sessions
+
+## Why don't use an existing solution?
+
+Existing solutions are:
+
+* [Beast](https://github.com/courtenay/altered_beast)
+* [Forem](https://github.com/radar/forem)
+* [Rails3-forums](https://github.com/smholloway/Rails3-forum)
+
+Beast has been inactive for 2 years. It's rails 2.2 and ruby 1.8. Don't need to say more.
+
+Rails3-forums has been inactive for 8 months. It does less than formol after 1.5 weeks of development.
+
+Forem is the most complete solution you can find in rails.
+Unfortunatly, it doesn't suit my needs.
+
+In addition, I had to "come back" to ruby (was programming Java for 1.5 year) and I've never written an engine, never used rails 3.1 for a real project.
+
+I decided then to write my own, with the best test coverage I can get (actually 99.3%).
+
+## Scaling
+
+I do my best to think about everything that could make this engine scale for devils:
+
+* every non 'eager-loadable' association (like first and last on has_many) is heavily cached with belongs_to.
+* there's counters cache everywhere
+* I'll introduce caching (or try to in any case) for very high scaling when the app is stable.
+* I use a lot of indexes
+
+## Compatibility
+
+Actually, formol is only tested with following parameters:
+
+* Ruby 1.9.2 
+* Rails 3.1.3
+* Ubuntu
+* Mysql
+
+When I would have read travis documentation, I'll test it on more platforms / db / rails versions (rails 3.2, ruby 1.9.3 & jruby, postgreSQL)
+
+## Installation
+
+As long as formol is in pre-alpha version, it won't be packaged as a gem.
+It should be installable as a rails plugin but I didn't try it.
+
+## Features
+
+* Administration
+  * categories
+  * forums
+* Topics
+  * locking topics
+  * viewing all topics for a forum
+  * creating new topics
+  * pinning topics
+  * tracking (read / unread by user)
+  * subscriptions (with not scaling mailing)
+  * polls & votes
+* Posts
+  * replying to topics
+  * deleting posts
+  * editing posts
+  * quoting
+  * display user's signature
+  * RTE
+* Text formatting
+  * markdown
+  * syntax highlighting
+* User preferences
+  * display signatures
+  * display avatars
+  * use signature by default
+  * signature
+* User permissions
+* Misc
+  * install generator
+  * gemspec
+  * basic styles
+
+## Preview
+
+Find other screenshots in /previews
+
+![Topic content](https://github.com/mulasse/formol/raw/master/preview/topic_show.png)
+
+## Dependencies
+
+At the moment, formol is independent from any auth system, but I still recommend [Devise](http://github.com/plataformatec/devise).
+Formol is highly coupled with will_paginate, you can't use it without will_paginate.
+
+Maybe I'll change this with something more flexible in the future.
+It's not planned for the moment because I don't know other solutions than will_paginate.
+
+Others:
+
+* JavaScript
+  * [jQuery](http://jquery.com)
+* Assets
+  * [Scss](http://sass-lang.com/)
+  * [CoffeeScript](http://coffeescript.org/)
+* Rails
+  * [Will_paginate](https://github.com/mislav/will_paginate)
+  * [Formtastic](https://github.com/justinfrench/formtastic)
+  * [Attribute normalizer](https://github.com/mdeering/attribute_normalizer)
+  * [Pygment.rb](https://github.com/tmm1/pygments.rb)
+  * [Redcarpet](https://github.com/tanoku/redcarpet)
+  * [Ranked-model](https://github.com/harvesthq/ranked-model) #=> want to abandon it for something simpler like act_as_list but for rails 3
+  * [Default_value_for](https://github.com/FooBarWidget/default_value_for)
+
+## Coming next
+
+* Mark all topics as read (actually have no scaling solution)
+* Soft delete topics (i'm not sure now since all tests failed because soft deletion doesn't trigger destroy callbacks)
+* Theme support
+* Generator (devise views)
+* Demo app
+* Selenium tests
+* More translations (french of course and more)
+* Permissions management (by admin)
+* Gravatars
+* Avatar uploading
+
+## Boring legal stuff
+
+Copyright 2011 Florian DUTEY
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,29 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Formol'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+Bundler::GemHelper.install_tasks
+
+task :default => 'app:spec'

data/app/assets/javascripts/formol/admin/categories.js.coffee

@@ -0,0 +1,55 @@
+#= require jquery
+#= require jquery-ui
+#= require jquery_ujs
+
+(($) ->
+  location = document.location.href.split('/admin')[0]
+
+  $ ->
+    $('.formol_categories').sortable({
+      axis: 'y',
+      stop: (event, ui) ->
+        nodes = $.map $('> li', $(this)), (li) ->
+          $(li).attr('id').match(/formol_category_(\d+)/)[1]
+      
+        $.ajax {
+          url:  location + '/admin/categories/sort',
+          type: 'POST',
+          data: {
+            _method:    'put',
+            categories: nodes
+          }
+        }
+    }).disableSelection()
+    
+    $('.formol_category_forums').sortable({
+      connectWith: '.formol_category_forums'
+      items: '> li:not(.empty)',
+      axis: 'y',
+      receive: (event, ui) -> 
+        self = $(this)
+        
+        if (empty = $('li.empty', self)).length == 1
+          empty.remove()
+        
+        if $('li', ui.sender).length == 0
+          $('<li></li>').addClass('empty').html('no forums').appendTo(ui.sender)
+      stop: (event, ui) ->
+        parent    = $(ui.item).parent()
+        parentId  = parent.attr('id').match(/formol_category_(\d+)_forums/)[1]
+        
+        #collect li ids
+        nodes = $.map $('> li', parent), (li) ->
+          $(li).attr('id').match(/formol_forum_(\d+)/)[1]
+
+        #TODO: use url helpers with rails-routes.js
+        $.ajax({
+          url:  location + '/admin/categories/' + parentId + '/forums/reorganize',
+          type: 'post',
+          data: {
+            _method:  'put',
+            forums:   nodes
+          }
+        })
+    }).disableSelection()
+)(jQuery)

data/app/assets/javascripts/formol/admin/forums.js

@@ -0,0 +1,2 @@
+// Place all the behaviors and hooks related to the matching controller here.
+// All this logic will automatically be available in application.js.

data/app/assets/javascripts/formol/application.js

@@ -0,0 +1,9 @@
+// This is a manifest file that'll be compiled into including all the files listed below.
+// Add new JavaScript/Coffee code in separate files in this directory and they'll automatically
+// be included in the compiled file accessible from http://example.com/assets/application.js
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// the compiled file.
+//
+//= require jquery
+//= require jquery-ui
+//= require jquery_ujs

data/app/assets/javascripts/formol/categories.js

@@ -0,0 +1,2 @@
+// Place all the behaviors and hooks related to the matching controller here.
+// All this logic will automatically be available in application.js.

data/app/assets/javascripts/formol/forums.js

@@ -0,0 +1,2 @@
+// Place all the behaviors and hooks related to the matching controller here.
+// All this logic will automatically be available in application.js.

data/app/assets/javascripts/formol/poll_votes.js

@@ -0,0 +1,2 @@
+// Place all the behaviors and hooks related to the matching controller here.
+// All this logic will automatically be available in application.js.

data/app/assets/javascripts/formol/posts.js.coffee

@@ -0,0 +1,9 @@
+#= require lib/jquery.prevent_double_submit
+#= require markitup/jquery.markitup.js
+#= require markitup/sets/markdown/set.js
+
+(($) ->
+  $ ->
+    $('form').preventDoubleSubmit()
+    $('textarea').markItUp(mySettings)
+)(jQuery)

data/app/assets/javascripts/formol/preferences.js

@@ -0,0 +1,2 @@
+// Place all the behaviors and hooks related to the matching controller here.
+// All this logic will automatically be available in application.js.

data/app/assets/javascripts/formol/subscriptions.js.coffee

@@ -0,0 +1,13 @@
+(($) ->
+  $ ->
+    $('.subscribe a').bind 'ajax:success', (event, XMLHttpRequest, ajaxOptions) -> 
+      element   = $(event.target)
+      method    = element.data('method')
+      txt       = element.data('switch-text')
+      switchTxt = element.text()
+      newMethod = if method == 'post' then 'delete' else 'post'
+      
+      element.data('method', newMethod)
+      element.data('switch-text', switchTxt)
+      element.text(txt)
+)(jQuery)

data/app/assets/javascripts/formol/topics.js.coffee

@@ -0,0 +1,54 @@
+#= require lib/jquery.prevent_double_submit
+#= require formol/subscriptions
+#= require markitup/jquery.markitup.js
+#= require markitup/sets/markdown/set.js
+
+(($) ->
+  $ ->
+    $('form').preventDoubleSubmit()
+    $('textarea').markItUp(mySettings)
+    
+    togglePollCheckbox = $('#topic_attach_poll')
+    pollContainer = $('fieldset.poll ol')
+    
+    togglePoll = () ->
+      pollContainer.toggle togglePollCheckbox.is(':checked')
+      
+    togglePoll()
+    
+    $(togglePollCheckbox).click () ->
+      togglePoll()
+    
+    poll_options = $('.answers li.input')
+    index = poll_options.length
+    
+    if index > 0
+      $('a.add_poll_option').click ->
+        id_replacement = [/_(\d)_/, '_' + index + '_']
+        name_replacement = [/\[(\d)\]/, '[' + index + ']']
+        replacement_meth  = String.prototype.replace
+      
+        new_line  = poll_options.eq(0).clone()
+        new_id    = replacement_meth.apply(new_line.attr('id'), id_replacement)
+        
+        new_line.attr('id', new_id)
+        
+        new_line.appendTo(poll_options.parent())
+        
+        new_input = new_line.find('input')
+        
+        new_id = replacement_meth.apply(new_input.attr('id'), id_replacement)
+        new_name  = replacement_meth.apply(new_input.attr('name'), name_replacement)
+        
+        new_input.attr('id', new_id)
+        new_input.attr('name', new_name)
+        new_input.val('')
+        
+        new_label = new_line.find('label')
+        
+        new_label.attr('for', new_id)
+        
+        index += 1
+        
+        false
+)(jQuery)

data/app/assets/javascripts/lib/jquery.prevent_double_submit.js.coffee

@@ -0,0 +1,11 @@
+(($) ->
+  $.fn.preventDoubleSubmit = () ->
+    $(@).submit ->
+      self = $(@)
+      
+      if @beenSubmitted
+        false
+      else
+        $('fieldset.buttons input', self).attr('disabled', true)
+        @beenSubmitted = true
+)(jQuery)