一、开始ActiveAdmin
Active Admin是一个发布在RAILS3中使用的Gem。
1、我们为了快速开始我们对Active Admin的了解,我们首先安装它:
在你GemFile中添加gem 'activeadmin'
2、更新你的Gem
bundle install
3、运行installer
rails generate active_admin:install
4、安装的installer会创建一个initializer,这个initializer采用Active Admin默认的配置,把所有需要的配置都写进一个文件夹app/admin里面。
同时,这个时候会显示相关的配置信息,并按照配置信息完成相关指示操作。
Some setup you must do manually if you haven't yet:
1. Ensure you have defined default url options in your environments files. Here
is an example of default_url_options appropriate for a development environment
in config/environments/development.rb:
config.action_mailer.default_url_options = { :host => 'localhost:3000' }
In production, :host should be set to the actual host of your application.
2. Ensure you have defined root_url to *something* in your config/routes.rb.
For example:
root :to => "home#index"
3. Ensure you have flash messages in app/views/layouts/application.html.erb.
For example:
<p class="notice"><%= notice %></p>
<p class="alert"><%= alert %></p>
4. If you are deploying Rails 3.1+ on Heroku, you may want to set:
config.assets.initialize_on_precompile = false
On config/application.rb forcing your application to not access the DB
or load models when precompiling your assets.
5. You can copy Devise views (for customization) to your app by running:
rails g devise:views
同时,这个时候会显示相关的配置信息,并按照配置信息完成相关指示操作。
Some setup you must do manually if you haven't yet:
1. Ensure you have defined default url options in your environments files. Here
is an example of default_url_options appropriate for a development environment
in config/environments/development.rb:
config.action_mailer.default_url_options = { :host => 'localhost:3000' }
In production, :host should be set to the actual host of your application.
2. Ensure you have defined root_url to *something* in your config/routes.rb.
For example:
root :to => "home#index"
3. Ensure you have flash messages in app/views/layouts/application.html.erb.
For example:
<p class="notice"><%= notice %></p>
<p class="alert"><%= alert %></p>
4. If you are deploying Rails 3.1+ on Heroku, you may want to set:
config.assets.initialize_on_precompile = false
On config/application.rb forcing your application to not access the DB
or load models when precompiling your assets.
5. You can copy Devise views (for customization) to your app by running:
rails g devise:views
完成以上操作,我们还需要配置邮件服务器
编辑config/initializers/devise.rb
编辑config/environments/development.rb
5、迁移你的db ,rake db:migrate,然后运行rails server 。
编辑config/initializers/devise.rb
# Configure the e-mail address which will be shown in DeviseMailer.
# Don't care if the mailer can't send
config.action_mailer.raise_delivery_errors =
true
#此处改为true
config.action_mailer.default_url_options = {
:host
=>
"localhost:3000"
}
#刚才devise的提示中提到这一句
config.action_mailer.delivery_method =
:smtp
config.action_mailer.smtp_settings = {
:address
=>
"smtp.126.com"
,
:port
=>
25
,
:domain
=>
"126.com"
,
:authentication
=>
:login
,
:password
=>
"xxxxxx"
#你的密码
}
5、迁移你的db ,rake db:migrate,然后运行rails server 。
密码:password
7、添加你的model
rails g model [MyModelName] name:string title:string content:text
8、将model放到admin目录中去
rails generate active_admin:resource [MyModelName]
这个命令会创建一个文件app/admin/my_model_names.rbl来配置你的resource。
刷新你的浏览器,看看这个时候的界面是怎么样的。
二、ActiveAdmin更新
你可以键入如下命令进行对它的升级
rails generate active_admin:assets
如果提示:uninitialized constant Admin::DashboardController
这个时候,需要dashboard view(app/admin/dashboards.rb)和初始化的时候一样。
三、下一步
2、AcitiveAdmin 的示例网址:demo.activeadmin.info
3、如果有问题,在这个网站的邮箱列表(groups.google.com/group/activeadmin)中发邮件。
四、补充说明
1、我在实际安装过程中,安装了很多的东西,这里我把安装过程中的gem一并写下来,就按gemfile里写的格式写下来。
gem 'activeadmin','0.5.1'
gem 'arbre','1.0.1'
gem 'bourbon','1.0.0'
gem 'devise','1.5.4'
gem 'formtastic','2.1.0'
gem 'has_scope','0.5.1'
gem 'inherited_resources','1.3.1'
gem 'meta_search','1.1.3'
gem 'orm_adapter','0.0.3'
gem 'polyamorous','0.5.0'
gem 'responders','0.6.5'
gem 'warden','1.1.1'
2、install过后,截图纪念一下
五、完成安装过后,又开始我们的下一个旅程——订制自己的后台。
1、给menu,index页面,form页面还有filter和help添加一些内容和中文命名
ActiveAdmin.register Post do
menu :label => "文章管理"
index do
column "标题",:title
column "作者",:name
column "内容",:content
default_actions
end
filter :title ,:label=>"标题"
filter :name ,:label=>"作者"
filter :content ,:label=>"内容"
form do |f|
f.inputs "添加标题和作者" do
f.input :title,:label=>"标题"
f.input :name,:label=>"作者"
end
f.inputs "添加内容" do
f.input :content,:label=>"文章内容"
end
f.buttons
end
sidebar :help,:only => :index do
"如果你对网站后台管理有问题,请联系[email protected]"
end
end
六、汉化页面
1、现在将整个页面汉化一下
1、现在将整个页面汉化一下
首先,我们已经在config/application.rb里配置了local为 zh-CN,
# The default locale is :en and all translations from config/locales/*.rb,yml are auto loaded.
config.i18n.load_path += Dir[Rails.root.join('config', 'locales', '*.{rb,yml}').to_s]
config.i18n.default_locale = "zh-CN"
然后到http://github.com/tsechingho/rails-i18n/blob/master/rails/locale/zh-CN.yml
下载已经配置好的中文包到config/locales里,这样,rails的中文化已经做好了。
2、devise的汉化
到该Wiki去下载汉化包 devise.zh-CN.yml
https://github.com/plataformatec/devise/wiki/I18n
然后删除原来的devise.en.yml
3、解决编码问题
在你需要显示汉语的*.rb文件中 ,添加一句代码
#encoding:utf-8