• Stars
    star
    489
  • Rank 89,970 (Top 2 %)
  • Language
    JavaScript
  • License
    MIT License
  • Created over 16 years ago
  • Updated about 11 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

cutting edge cms, blog, wiki, forum ...
Welcome to adva-cms
===================

adva-cms is a cutting edge open source application platform based on Ruby on
Rails and Rails Engines.

Different from others, adva-cms lives in vendor directory and keeps your main
app directory clean and dandy. So you can reclaim app directory and use it
only for your own application files.

adva-cms makes it extensible: you can only pick those engines/features you really
need for your application and omit the rest. All engines are designed to work
together seamlessly, so the whole platform feels much more consistent for
similar but separate Rails applications.

Please check out /doc directory and our site http://adva-cms.org for more info.

Installation: Release 0.3.2
===========================

Required: Rails >= 2.3.4, ImageMagick for image handling

# install Rails >= 2.3.4 gems if you don't have them already
  sudo gem install rails --version 2.3.4

# install and setup adva-cms using a template
  rails my-app -m https://github.com/svenfuchs/adva_cms/raw/master/templates/adva-cms.0.3.2.rb

# there's no step 3
  cd my-app
  ruby script/server
  open http://localhost:3000

You should see adva-cms installation screen.
Fill out the form and you're started, enjoy!

You can install additional engines and plugins through rake adva:install. See
below for more about that.

*Important note for using adva-cms with Rails >= 2.3.4*

You *must* use Rails' old routing recognition/generation mode in order for adva-cms to work correctly:

  # config/initializers/new_rails_defaults.rb
  # either comment out the following line or set it to true
  ActionController::Routing.generate_best_match = false


Installation: Edge version using rails template
===============================================

Required: Rails >= 2.3.4, ImageMagick for image handling

# install Rails >= 2.3.4 gems if you don't have them already
  sudo gem install rails --version 2.3.4

# install and setup adva-cms using a template
  rails my-app -m https://github.com/svenfuchs/adva_cms/raw/master/templates/adva-cms.master.rb

# there's no step 3
  cd my-app
  ruby script/server
  open http://localhost:3000

You should see adva-cms installation screen.
Fill out the form and you're started, enjoy!

You can install additional engines and plugins through rake adva:install. See
below for more about that.


Installation: Edge version manually
===================================
(this is basically what the template does...)

Required: Rails >= 2.3.4 or newer, ImageMagick for image handling

# Create your app
  rails my-app
  cd my-app
  rm public/index.html

# Prepare the config/environment.rb and remove the public/index.html
  # in config/environment.rb make sure you have:
  require File.join(File.dirname(__FILE__), 'boot')
  require File.join(File.dirname(__FILE__), '../vendor/adva/engines/adva_cms/boot') # this line

# You *must* use Rails' old routing recognition/generation mode in order for adva-cms to work correctly:
  # in config/initializers/new_rails_defaults.rb set:
  ActionController::Routing.generate_best_match = true

# Clone the adva-cms ( this might take a bit, grab a coffee meanwhile :) )
  git clone git://github.com/svenfuchs/adva_cms.git vendor/adva    # or use: git submodule add ...

# Install the core engines and copy the assets
  rake adva:install:core -R vendor/adva/engines/adva_cms/lib/tasks # install adva-cms to vendor/plugins/
  rake adva:assets:install                                         # symlinks plugin assets to public/

# Start the server
  ruby script/server
  open http://localhost:3000

You should see adva-cms installation screen.
Fill out the form and you're started, enjoy!


Installing/Uninstalling adva-cms engines and plugins
====================================================

You can install/uninstall adva-cms engines and plugins by using a set of rake
tasks. Installation simply works by symlinking (copying on Windows) to
vendor/plugins.

There are the following tasks/subtasks:

  rake adva:install:all
  rake adva:install:core
  rake adva:install

  rake adva:uninstall:all
  rake adva:uninstall:core
  rake adva:uninstall

For each of these tasks you can specify the option except and give it a list
of engine/plugin names that should be excluded from the install/ uninstall
task. E.g.

  rake adva:install:all except=adva_themes,adva_wiki
  rake adva:uninstall:all except=adva_themes,adva_wiki

For the tasks adva:install and adva:uninstall one can specify the options
engines and plugins and give it a list of engine/plugin names that should be
included to the task. E.g.

  rake adva:install engines=adva_themes,adva_wiki plugins=adva_url_history
  rake adva:uninstall engines=adva_themes,adva_wiki plugins=adva_url_history

(Incidentally, for the task adva:install:core one can specify the plugins
option in the same way and thus install all core engines plus certain
plugins.)

For both the engines and plugins options one can specify the keyword "all"
which then expands to all available engines and plugins respectively. Thus,
these are equivalent:

  rake adva:install:all
  rake adva:install engines=all plugins=all

When the "all" keyword is used with the uninstall task this only applies to
all engines and plugins except the adva-cms core engines. To uninstall these
you can still simply delete the symlinks (directories on Windows) from
vendor/plugins.

NOTE please note that right now assets not installed to public/ when engines are
installed and they are not removed from public/ when engines are uninstalled.
So after you've installed additional engines you'll most probably want to
install the assets to public:

  rake adva:assets:install


Configuration
=============

You can change adva-cms configuration by including an initializer to your
application and overwriting things that adva-cms sets as defaults. See the
initializers in adva-cms engines/plugins, e.g. in

  vendor/plugins/adva_cms/config/initializers/*


Running tests
=============

The test-suite is intended to run on full install in an otherwise clean rails-app.

Running tests for adva-cms version 0.1.2 or newer:

  $ rake adva:install:all                               # to prepare the database, all engines are needed
  $ sudo gem install mocha                              # We depend on this gem in some of our tests

  $ rake db:test:clone                                  # Clones from your development database to test database
  $ vendor/adva/script/test_prepare_database            # Prepares database
  $ vendor/adva/script/test vendor/adva/engines         # Runs all tests

Further options:

  $ vendor/adva/script/test vendor/adva/engines -p      # Prepares the database and runs all adva-cms tests
  $ DO_NOT_REPORT_ASAP=true vendor/adva/script/test vendor/adva/engines  # run all tests but only report errors in the summary

Please check out /doc directory for high level overview about adva-cms.


Installing Selenium
===================

$ (sudo) gem install Selenium selenium-client


Unfortunately the jar that the Selenium gem (version 1.1.14) comes with does not work with Firefox 3. So we have to get the latest jar from the Selenium-RC site:

Download the Selenium RC Beta 2:

http://seleniumhq.org/download/

Once you have extracted the download we copy:

selenium-remote-control-1.0-beta-2/selenium-server-1.0-beta-2/selenium-server.jar

Over the jar that was installed with the Selenium gem:

GEM_INSTALL_DIR/Selenium-1.1.14/lib/selenium/openqa/selenium-server.jar.txt # yes, with .txt in the end


Development
===========

Please report bugs to Lighthouse:
  http://artweb-design.lighthouseapp.com/projects/13992-adva_cms/overview

Git repository:
  http://github.com/svenfuchs/adva_cms/tree/master

adva-cms mailing list:
  http://groups.google.com/group/adva-cms

adva-cms irc:
  irc://irc.freenode.net#adva-cms


Developers
==========

Sven Fuchs
Marko SeppΓ€
Clemens Kofler
Matthias Viehweger
Christopher Floess
Raphala Wrede
Johannes Strampe
Priit Tamboom
Thomas R. Koll
Joshua Harvey
Luca Guidi
Mark Schlusnus

More Repositories

1

rails-i18n

Repository for collecting Locale data for Ruby on Rails I18n as well as other interesting, Rails related I18n stuff
Ruby
3,979
star
2

gem-release

Release your ruby gems with ease.
Ruby
512
star
3

routing-filter

routing-filter wraps around the complex beast that the Rails routing system is, allowing for unseen flexibility and power in Rails URL recognition and generation.
Ruby
463
star
4

i18n-active_record

I18n ActiveRecord backend
Ruby
281
star
5

adva-cms2

Cutting edge Rails 3 CMS framework
Ruby
115
star
6

hashr

Simple Hash extension to make working with nested hashes (e.g. for configuration) easier and less error-prone.
Ruby
109
star
7

simple_states

A super-slim statemachine-like support library
Ruby
95
star
8

steam

Headless integration testing w/ HtmlUnit: enables testing JavaScript-driven web sites
JavaScript
51
star
9

ripper2ruby

Similar to ruby2ruby this library allows to parse Ruby code, modify and recompile it back to Ruby.
Ruby
41
star
10

simple_opts.sh

Simple Bash option parser
Shell
31
star
11

i18n-missing_translations

Find missing translations in your code more easily.
Ruby
31
star
12

scriptaculous-sortabletree

Implements a sortable tree for scriptacolous
JavaScript
29
star
13

minimal

Minimal templating engine inspired by Markaby & Erector but much smaller and targeting Rails 3
Ruby
26
star
14

rdom

experimental browser implementation in ruby using nokogiri and johnson
Ruby
25
star
15

simple_nested_set

Ruby
22
star
16

space

multi-repository monitoring and shell helper tool to ease development across multiple dependent repositories
Ruby
17
star
17

activesupport-slices

Lazy loaded vertical code slices based on ActiveSupport Dependencies
Ruby
14
star
18

capture_stdout

Adds Kernel.capture_stdout(&block). Useful e.g. for testing command line tools
Ruby
14
star
19

data_migrations

Ruby
14
star
20

vim-tree

vim filesystem tree plugin in ruby
Ruby
13
star
21

rack-cache-purge

Support for purging rack-cache
Ruby
13
star
22

cl

Object-oriented OptionParser based CLI support for rapid CLI development
Ruby
12
star
23

i18n-tools

Tools for working with ruby/rails i18n
Ruby
10
star
24

vim-todo

Provides a simple todo list similar to Textmate’s todo.bundle
Ruby
10
star
25

reference_tracking

Ruby
10
star
26

locator

Generic html element locators for testing tools
Ruby
9
star
27

taskmate

Simplistic TextMate bundle for getting more done with your favorite missing text editor.
Ruby
9
star
28

scrumtious

toying with a remote scrum tool pulling from lighthouse for
Ruby
7
star
29

mephisto_paged_article_list

Mephisto doesn't page article lists out of the box. This plugin adds that.
Ruby
6
star
30

stubby

lightweight and fast stubbing framework
Ruby
6
star
31

with

highly experimental, lightweight and flexible contexts for test/unit
Ruby
6
star
32

resque-heartbeat

Ruby
6
star
33

activemodel-error

I18n support for validation error messages in ActiveModel
Ruby
6
star
34

vim-layout

Ruby
5
star
35

simple_slugs

Ruby
5
star
36

micro_migrations

Minimal ActiveRecord standalone migrations
Ruby
5
star
37

inherited_resources_helpers

Ruby
5
star
38

google_analytics

This plugin is primarily targeted at being used with Mephisto but should be useful with other Rails based CMS or blogging plattforms, too.
Ruby
5
star
39

test_server

Playing around with a test server for Rails that keeps the environment loaded (just like spec_server)
Ruby
5
star
40

will_paginate_liquidized

This plugin allows you to use will_paginate with Liquid templates. That's it.
Ruby
4
star
41

ruby-i18n.tmbundle

Ruby
4
star
42

middleman-toc

Ruby
4
star
43

rjb-require

Adds the ability to import and map Java packages to nested Ruby modules/classes to RJB.
Ruby
4
star
44

globalize-rails.org

Ruby
3
star
45

resque-tagged_queues

Ruby
3
star
46

sh_vars

Shell variable parser
Ruby
3
star
47

em-stdout

Ruby
3
star
48

rack-cache-tags

Support for tagging rack-cache entries
Ruby
3
star
49

rbac

Ruby
3
star
50

with-sugar

Test macros for being used with With
Ruby
3
star
51

treetop_css

Treetop CSS grammar/parser
Ruby
3
star
52

i18n-message

Object-oriented abstraction for looking up translations from I18n.translate
Ruby
3
star
53

adva-cms.org

Ruby
3
star
54

mephisto_tag_cloud

Most complete, sophisticated, standard-conform and allover-awesome implementation of a tag cloud plugin for Mephisto :)
Ruby
3
star
55

mephisto_full_archives

simple plugin that adds a full archives view to Mephisto's own archives
Ruby
2
star
56

bash_opts

SImple Bash options parser
Shell
2
star
57

test_declarative

Simply adds a declarative test method syntax to test/unit
Ruby
2
star
58

simple_taggable

Ruby
2
star
59

dotfiles

Vim Script
2
star
60

mephisto_inverse_captcha

Mephisto anti-comment-spam plugin that adds an "outer floodgate" to the existing (Akismet) spam-protection
Ruby
2
star
61

trsh

Experimental Travis CI Shell using API v3 in Go
Go
2
star
62

uki_reader

Experimental Google Reader UI based on Uki
JavaScript
2
star
63

travis

2
star
64

travis-lxc

Ruby
2
star
65

vim-deliminator

Balancing brackets and quotes
Ruby
1
star
66

database_recorder

Ruby
1
star
67

identity

Ruby
1
star
68

gmail_filters

Ruby
1
star
69

ruby-i18n.org

ruby-i18n.org - static html export, see the source branch for sources
Ruby
1
star
70

command

Ruby
1
star
71

registry

Ruby Class Registry
Ruby
1
star
72

travis-worker

Ruby
1
star
73

pathname_local

Ruby
1
star
74

dom-test

Ruby export of Level 1 and 2 W3C DOM tests
Ruby
1
star
75

led-go

A line editor in Go. Inspired by linenoise, but written with extensibility and separation of concerns in mind.
Go
1
star
76

svenfuchs.github.com

jo
HTML
1
star
77

rails-i18n-chart

Ruby
1
star
78

box

C++
1
star
79

statics

Ruby
1
star
80

silence_log_tailer

Silence rails/server log tailing to console
Ruby
1
star