Skip to content
This repository has been archived by the owner on Jun 7, 2021. It is now read-only.

Commit

Permalink
Typo and formatting fixes to UPGRADING.markdown.
Browse files Browse the repository at this point in the history
  • Loading branch information
Trevor Bullock committed Dec 16, 2014
1 parent cd103e8 commit ded54d5
Showing 1 changed file with 46 additions and 36 deletions.
82 changes: 46 additions & 36 deletions UPGRADING.markdown
Original file line number Diff line number Diff line change
@@ -1,61 +1,67 @@
Upgrading to v3.0.0
===================
Follow the various guides for converting to Rails 4 from Rails 3.x
* Follow the various guides for converting from Rails 3.x to Rails 4
* Run `bundle exec rake app:community_engine:install:migrations`
* Run `rake db:migrate`
* Run `rake test && take community_engine:test`

Run `bundle exec rake app:community_engine:install:migrations`
Run `rake db:migrate`
Run `rake test && take community_engine:test`

Somethings may not be compatible. Some of the views and forms have changed.
Some things may not be compatible; some of the views and forms have changed.

Upgrading to v1.2.1
===================
Run `ruby script/generate plugin_migration`
Run `rake db:migrate`
Run `rake test && rake community_engine:test`
* Run `ruby script/generate plugin_migration`
* Run `rake db:migrate`
* Run `rake test && rake community_engine:test`


Upgrading to v1.2.0
===================
Run `ruby script/generate plugin_migration`
Run `rake db:migrate`
Run `rake test && rake community_engine:test`
* Run `ruby script/generate plugin_migration`
* Run `rake db:migrate`
* Run `rake test && rake community_engine:test`

To migrate existing private messages to the new threaded message format, run `rake community_engine:add_threads_to_existing_messages` on your production server (CAREFUL: make backups first!)


Upgrading to v1.1.0
=====================
Run `ruby script/generate plugin_migration`
Run `rake db:migrate`
Run `rake test && rake community_engine:test`
* Run `ruby script/generate plugin_migration`
* Run `rake db:migrate`
* Run `rake test && rake community_engine:test`


Upgrading to v1.0.4.2
=====================
Run `rake gems:install`
Run `ruby script/generate plugin_migration`
Run `rake db:migrate`
Run `rake test && rake community_engine:test`
* Run `rake gems:install`
* Run `ruby script/generate plugin_migration`
* Run `rake db:migrate`
* Run `rake test && rake community_engine:test`

That's it!

Note: this version adds a counter_cache to taggings, so you may need to update the counter on your existing tags by doing something like:

```ruby
ActsAsTaggableOn::Tag.all.each do |tag|
tag.update_counters tag.id, :taggings_count => tag.taggings.length
tag.update_counters tag.id, :taggings_count => tag.taggings.length
end
```

If you have many tags, this could take a while, though.
If you have many tags, this could take a while.

Upgrading to v1.0.4
===================
Run `ruby script/generate plugin_migration`
Make sure you have the following in your `environment.rb`:
* Run `ruby script/generate plugin_migration`.
* Make sure you have the following in your `environment.rb`:

```
config.gem 'authlogic'
config.gem 'icalendar'
config.gem 'calendar_date_select'
```

config.gem 'authlogic'
config.gem 'icalendar'
config.gem 'calendar_date_select'
* Run `rake db:migrate`

Run `rake db:migrate`
That's it!


Expand All @@ -71,18 +77,18 @@ Upgrading an Engines-based CE app to use the new Desert-based CE is easy:

2. Delete the engines plugin directory (`rm -rf vendor/plugins/engines`). If you had submoduled it, make sure to delete the submodule info as well:

Delete the relevant line from the .gitmodules file.
Delete the relevant section from .git/config.
Run git rm --cached vendor/plugins/engines (no trailing slash).
Run rm -rf vendor/plugins/engines
Commit your changes
* Delete the relevant line from the `.gitmodules` file
* Delete the relevant section from `.git/config`
* Run `git rm --cached vendor/plugins/engines` (no trailing slash)
* Run `rm -rf vendor/plugins/engines`
* Commit your changes


2. run `rake:rails:update` (coming from anything < Rails 2.3)
2. Run `rake:rails:update` (coming from anything < Rails 2.3)

3. Update your app's `test_helper.rb`, replacing `Test::Unit::TestCase` with `ActiveSupport::TestCase`

4. `rake test` && `rake community_engine:test`
4. Run `rake test` && `rake community_engine:test`



Expand All @@ -94,10 +100,14 @@ Here's a regex that might help you in doing that:

Find:

(Engines|Rails)\.plugins\[\"community_engine\"\]\.migrate\(([0-9]+)\)
```
(Engines|Rails)\.plugins\[\"community_engine\"\]\.migrate\(([0-9]+)\)
```

Replace:

migrate_plugin(:community_engine, $2)
```
migrate_plugin(:community_engine, $2)`
```

Also, you need to run `rake community_engine:db:migrate:upgrade_desert_plugin_migrations` before you migrate any _new_ CE migrations, to ensure your plugin migrations are listed in the correct table. Please note that you'll have to do this (carefully, and with backups) in production as well. Please post any questions to the CE Google Group.

0 comments on commit ded54d5

Please sign in to comment.