nsm-activeadmin 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (321) hide show
  1. data/.document +5 -0
  2. data/.gitignore +34 -0
  3. data/.travis.yml +4 -0
  4. data/.yardopts +8 -0
  5. data/CHANGELOG.rdoc +76 -0
  6. data/Gemfile +39 -0
  7. data/LICENSE +25 -0
  8. data/README.rdoc +487 -0
  9. data/Rakefile +27 -0
  10. data/activeadmin.gemspec +28 -0
  11. data/app/assets/images/active_admin/admin_notes_icon.png +0 -0
  12. data/app/assets/images/active_admin/datepicker/datepicker-header-bg.png +0 -0
  13. data/app/assets/images/active_admin/datepicker/datepicker-input-icon.png +0 -0
  14. data/app/assets/images/active_admin/datepicker/datepicker-next-link-icon.png +0 -0
  15. data/app/assets/images/active_admin/datepicker/datepicker-nipple.png +0 -0
  16. data/app/assets/images/active_admin/datepicker/datepicker-prev-link-icon.png +0 -0
  17. data/app/assets/images/active_admin/loading.gif +0 -0
  18. data/app/assets/images/active_admin/nested_menu_arrow.gif +0 -0
  19. data/app/assets/images/active_admin/nested_menu_arrow_dark.gif +0 -0
  20. data/app/assets/images/active_admin/orderable.png +0 -0
  21. data/app/assets/javascripts/active_admin/base.js +12 -0
  22. data/app/assets/javascripts/active_admin/vendor.js +382 -0
  23. data/app/assets/stylesheets/active_admin/_base.css.scss +400 -0
  24. data/app/assets/stylesheets/active_admin/_forms.css.scss +256 -0
  25. data/app/assets/stylesheets/active_admin/_header.css.scss +110 -0
  26. data/app/assets/stylesheets/active_admin/_mixins.css.scss +1 -0
  27. data/app/assets/stylesheets/active_admin/_typography.css.scss +100 -0
  28. data/app/assets/stylesheets/active_admin/components/_comments.css.scss +40 -0
  29. data/app/assets/stylesheets/active_admin/components/_date_picker.css.scss +123 -0
  30. data/app/assets/stylesheets/active_admin/components/_flash_messages.css.scss +38 -0
  31. data/app/assets/stylesheets/active_admin/mixins/_all.css.scss +8 -0
  32. data/app/assets/stylesheets/active_admin/mixins/_buttons.css.scss +27 -0
  33. data/app/assets/stylesheets/active_admin/mixins/_gradients.css.scss +29 -0
  34. data/app/assets/stylesheets/active_admin/mixins/_icons.css.scss +20 -0
  35. data/app/assets/stylesheets/active_admin/mixins/_reset.css.scss +165 -0
  36. data/app/assets/stylesheets/active_admin/mixins/_rounded.css.scss +43 -0
  37. data/app/assets/stylesheets/active_admin/mixins/_sections.css.scss +34 -0
  38. data/app/assets/stylesheets/active_admin/mixins/_shadows.css.scss +21 -0
  39. data/app/assets/stylesheets/active_admin/mixins/_variables.css.scss +21 -0
  40. data/app/views/active_admin/dashboard/index.html.arb +1 -0
  41. data/app/views/active_admin/devise/mailer/reset_password_instructions.html.erb +8 -0
  42. data/app/views/active_admin/devise/mailer/unlock_instructions.html.erb +7 -0
  43. data/app/views/active_admin/devise/passwords/edit.html.erb +16 -0
  44. data/app/views/active_admin/devise/passwords/new.html.erb +14 -0
  45. data/app/views/active_admin/devise/sessions/new.html.erb +18 -0
  46. data/app/views/active_admin/devise/shared/_links.erb +20 -0
  47. data/app/views/active_admin/devise/unlocks/new.html.erb +12 -0
  48. data/app/views/active_admin/resource/edit.html.arb +1 -0
  49. data/app/views/active_admin/resource/index.csv.erb +20 -0
  50. data/app/views/active_admin/resource/index.html.arb +1 -0
  51. data/app/views/active_admin/resource/new.html.arb +1 -0
  52. data/app/views/active_admin/resource/show.html.arb +1 -0
  53. data/app/views/layouts/active_admin.html.arb +1 -0
  54. data/app/views/layouts/active_admin_logged_out.html.erb +35 -0
  55. data/cucumber.yml +2 -0
  56. data/docs/1-general-configuration.md +52 -0
  57. data/docs/2-resource-customization.md +35 -0
  58. data/docs/3-index-pages.md +55 -0
  59. data/docs/3-index-pages/index-as-block.md +16 -0
  60. data/docs/3-index-pages/index-as-blog.md +61 -0
  61. data/docs/3-index-pages/index-as-grid.md +21 -0
  62. data/docs/3-index-pages/index-as-table.md +74 -0
  63. data/docs/4-csv-format.md +14 -0
  64. data/docs/5-forms.md +39 -0
  65. data/docs/6-show-screens.md +22 -0
  66. data/docs/7-sidebars.md +35 -0
  67. data/docs/8-custom-actions.md +123 -0
  68. data/features/comments/commenting.feature +112 -0
  69. data/features/comments/viewing_index.feature +19 -0
  70. data/features/dashboard.feature +26 -0
  71. data/features/edit_page.feature +106 -0
  72. data/features/first_boot.feature +16 -0
  73. data/features/global_navigation.feature +30 -0
  74. data/features/index/format_as_csv.feature +46 -0
  75. data/features/index/formats.feature +12 -0
  76. data/features/index/index_as_block.feature +15 -0
  77. data/features/index/index_as_blog.feature +50 -0
  78. data/features/index/index_as_grid.feature +45 -0
  79. data/features/index/index_as_table.feature +81 -0
  80. data/features/index/index_blank_slate.feature +55 -0
  81. data/features/index/index_scopes.feature +52 -0
  82. data/features/index/pagination.feature +17 -0
  83. data/features/menu.feature +26 -0
  84. data/features/new_page.feature +75 -0
  85. data/features/registering_assets.feature +35 -0
  86. data/features/registering_resources.feature +33 -0
  87. data/features/show/default_content.feature +43 -0
  88. data/features/show/page_title.feature +33 -0
  89. data/features/sidebar_sections.feature +127 -0
  90. data/features/specifying_actions.feature +87 -0
  91. data/features/step_definitions/action_item_steps.rb +7 -0
  92. data/features/step_definitions/additional_web_steps.rb +77 -0
  93. data/features/step_definitions/asset_steps.rb +7 -0
  94. data/features/step_definitions/attribute_steps.rb +13 -0
  95. data/features/step_definitions/comment_steps.rb +8 -0
  96. data/features/step_definitions/configuration_steps.rb +31 -0
  97. data/features/step_definitions/dashboard_steps.rb +11 -0
  98. data/features/step_definitions/factory_steps.rb +29 -0
  99. data/features/step_definitions/flash_steps.rb +3 -0
  100. data/features/step_definitions/format_steps.rb +35 -0
  101. data/features/step_definitions/index_scope_steps.rb +20 -0
  102. data/features/step_definitions/layout_steps.rb +3 -0
  103. data/features/step_definitions/menu_steps.rb +7 -0
  104. data/features/step_definitions/pagination_steps.rb +8 -0
  105. data/features/step_definitions/sidebar_steps.rb +7 -0
  106. data/features/step_definitions/tab_steps.rb +3 -0
  107. data/features/step_definitions/user_steps.rb +26 -0
  108. data/features/step_definitions/web_steps.rb +211 -0
  109. data/features/sti_resource.feature +61 -0
  110. data/features/support/env.rb +90 -0
  111. data/features/support/paths.rb +50 -0
  112. data/features/support/selectors.rb +45 -0
  113. data/features/users/logging_in.feature +34 -0
  114. data/features/users/logging_out.feature +13 -0
  115. data/lib/active_admin.rb +74 -0
  116. data/lib/active_admin/abstract_view_factory.rb +95 -0
  117. data/lib/active_admin/application.rb +228 -0
  118. data/lib/active_admin/arbre.rb +23 -0
  119. data/lib/active_admin/arbre/attributes.rb +20 -0
  120. data/lib/active_admin/arbre/class_list.rb +28 -0
  121. data/lib/active_admin/arbre/collection.rb +27 -0
  122. data/lib/active_admin/arbre/context.rb +14 -0
  123. data/lib/active_admin/arbre/core_extensions.rb +5 -0
  124. data/lib/active_admin/arbre/document.rb +42 -0
  125. data/lib/active_admin/arbre/element.rb +151 -0
  126. data/lib/active_admin/arbre/html.rb +84 -0
  127. data/lib/active_admin/arbre/html5_elements.rb +47 -0
  128. data/lib/active_admin/arbre/tag.rb +137 -0
  129. data/lib/active_admin/arbre/text_node.rb +35 -0
  130. data/lib/active_admin/asset_registration.rb +34 -0
  131. data/lib/active_admin/callbacks.rb +89 -0
  132. data/lib/active_admin/comments.rb +88 -0
  133. data/lib/active_admin/comments/comment.rb +21 -0
  134. data/lib/active_admin/comments/configuration.rb +18 -0
  135. data/lib/active_admin/comments/namespace_helper.rb +14 -0
  136. data/lib/active_admin/comments/resource_helper.rb +17 -0
  137. data/lib/active_admin/comments/show_page_helper.rb +23 -0
  138. data/lib/active_admin/comments/views.rb +3 -0
  139. data/lib/active_admin/comments/views/active_admin_comment.rb +0 -0
  140. data/lib/active_admin/comments/views/active_admin_comments.rb +82 -0
  141. data/lib/active_admin/component.rb +22 -0
  142. data/lib/active_admin/controller_action.rb +12 -0
  143. data/lib/active_admin/csv_builder.rb +45 -0
  144. data/lib/active_admin/dashboards.rb +48 -0
  145. data/lib/active_admin/dashboards/dashboard_controller.rb +38 -0
  146. data/lib/active_admin/dashboards/section.rb +34 -0
  147. data/lib/active_admin/deprecation.rb +36 -0
  148. data/lib/active_admin/devise.rb +43 -0
  149. data/lib/active_admin/dsl.rb +224 -0
  150. data/lib/active_admin/engine.rb +4 -0
  151. data/lib/active_admin/event.rb +31 -0
  152. data/lib/active_admin/form_builder.rb +109 -0
  153. data/lib/active_admin/helpers/optional_display.rb +34 -0
  154. data/lib/active_admin/helpers/settings.rb +63 -0
  155. data/lib/active_admin/iconic.rb +51 -0
  156. data/lib/active_admin/iconic/icons.rb +142 -0
  157. data/lib/active_admin/locales/da.yml +28 -0
  158. data/lib/active_admin/locales/en.yml +40 -0
  159. data/lib/active_admin/locales/es.yml +39 -0
  160. data/lib/active_admin/locales/it.yml +39 -0
  161. data/lib/active_admin/locales/pt-BR.yml +36 -0
  162. data/lib/active_admin/locales/ru.yml +40 -0
  163. data/lib/active_admin/locales/zh_cn.yml +40 -0
  164. data/lib/active_admin/menu.rb +42 -0
  165. data/lib/active_admin/menu_item.rb +73 -0
  166. data/lib/active_admin/namespace.rb +206 -0
  167. data/lib/active_admin/page_config.rb +15 -0
  168. data/lib/active_admin/reloader.rb +30 -0
  169. data/lib/active_admin/renderer.rb +87 -0
  170. data/lib/active_admin/resource.rb +151 -0
  171. data/lib/active_admin/resource/action_items.rb +88 -0
  172. data/lib/active_admin/resource/belongs_to.rb +31 -0
  173. data/lib/active_admin/resource/menu.rb +45 -0
  174. data/lib/active_admin/resource/naming.rb +36 -0
  175. data/lib/active_admin/resource/scopes.rb +33 -0
  176. data/lib/active_admin/resource/sidebars.rb +36 -0
  177. data/lib/active_admin/resource_controller.rb +103 -0
  178. data/lib/active_admin/resource_controller/action_builder.rb +21 -0
  179. data/lib/active_admin/resource_controller/actions.rb +79 -0
  180. data/lib/active_admin/resource_controller/callbacks.rb +47 -0
  181. data/lib/active_admin/resource_controller/collection.rb +144 -0
  182. data/lib/active_admin/resource_controller/filters.rb +58 -0
  183. data/lib/active_admin/resource_controller/form.rb +42 -0
  184. data/lib/active_admin/resource_controller/menu.rb +29 -0
  185. data/lib/active_admin/resource_controller/page_configurations.rb +53 -0
  186. data/lib/active_admin/resource_controller/scoping.rb +36 -0
  187. data/lib/active_admin/resource_controller/sidebars.rb +18 -0
  188. data/lib/active_admin/router.rb +85 -0
  189. data/lib/active_admin/sass/active_admin.scss +3 -0
  190. data/lib/active_admin/sass/css_loader.rb +16 -0
  191. data/lib/active_admin/sass/helpers.rb +40 -0
  192. data/lib/active_admin/scope.rb +17 -0
  193. data/lib/active_admin/sidebar_section.rb +41 -0
  194. data/lib/active_admin/stylesheets/active_admin/mixins/_utilities.scss +0 -0
  195. data/lib/active_admin/version.rb +3 -0
  196. data/lib/active_admin/view_factory.rb +23 -0
  197. data/lib/active_admin/view_helpers.rb +22 -0
  198. data/lib/active_admin/view_helpers/active_admin_application_helper.rb +12 -0
  199. data/lib/active_admin/view_helpers/assigns_with_indifferent_access_helper.rb +7 -0
  200. data/lib/active_admin/view_helpers/auto_link_helper.rb +42 -0
  201. data/lib/active_admin/view_helpers/breadcrumb_helper.rb +29 -0
  202. data/lib/active_admin/view_helpers/display_helper.rb +38 -0
  203. data/lib/active_admin/view_helpers/filter_form_helper.rb +186 -0
  204. data/lib/active_admin/view_helpers/form_helper.rb +13 -0
  205. data/lib/active_admin/view_helpers/icon_helper.rb +12 -0
  206. data/lib/active_admin/view_helpers/method_or_proc_helper.rb +26 -0
  207. data/lib/active_admin/view_helpers/renderer_helper.rb +29 -0
  208. data/lib/active_admin/view_helpers/sidebar_helper.rb +15 -0
  209. data/lib/active_admin/view_helpers/title_helper.rb +11 -0
  210. data/lib/active_admin/view_helpers/view_factory_helper.rb +11 -0
  211. data/lib/active_admin/views.rb +8 -0
  212. data/lib/active_admin/views/action_items.rb +17 -0
  213. data/lib/active_admin/views/components/attributes_table.rb +66 -0
  214. data/lib/active_admin/views/components/blank_slate.rb +33 -0
  215. data/lib/active_admin/views/components/columns.rb +47 -0
  216. data/lib/active_admin/views/components/paginated_collection.rb +92 -0
  217. data/lib/active_admin/views/components/panel.rb +26 -0
  218. data/lib/active_admin/views/components/scopes.rb +70 -0
  219. data/lib/active_admin/views/components/sidebar_section.rb +28 -0
  220. data/lib/active_admin/views/components/status_tag.rb +55 -0
  221. data/lib/active_admin/views/components/table_for.rb +193 -0
  222. data/lib/active_admin/views/dashboard_section_renderer.rb +19 -0
  223. data/lib/active_admin/views/header_renderer.rb +53 -0
  224. data/lib/active_admin/views/index_as_block.rb +29 -0
  225. data/lib/active_admin/views/index_as_blog.rb +129 -0
  226. data/lib/active_admin/views/index_as_grid.rb +70 -0
  227. data/lib/active_admin/views/index_as_table.rb +148 -0
  228. data/lib/active_admin/views/pages/base.rb +155 -0
  229. data/lib/active_admin/views/pages/dashboard.rb +62 -0
  230. data/lib/active_admin/views/pages/edit.rb +28 -0
  231. data/lib/active_admin/views/pages/index.rb +74 -0
  232. data/lib/active_admin/views/pages/layout.rb +26 -0
  233. data/lib/active_admin/views/pages/new.rb +28 -0
  234. data/lib/active_admin/views/pages/show.rb +56 -0
  235. data/lib/active_admin/views/tabs_renderer.rb +58 -0
  236. data/lib/activeadmin.rb +1 -0
  237. data/lib/generators/active_admin/assets/assets_generator.rb +21 -0
  238. data/lib/generators/active_admin/assets/templates/3.0/active_admin.js +427 -0
  239. data/lib/generators/active_admin/assets/templates/3.1/active_admin.css.scss +6 -0
  240. data/lib/generators/active_admin/assets/templates/3.1/active_admin.js +1 -0
  241. data/lib/generators/active_admin/assets/templates/dashboards.rb +36 -0
  242. data/lib/generators/active_admin/devise/devise_generator.rb +49 -0
  243. data/lib/generators/active_admin/install/install_generator.rb +44 -0
  244. data/lib/generators/active_admin/install/templates/active_admin.rb.erb +93 -0
  245. data/lib/generators/active_admin/install/templates/dashboards.rb +38 -0
  246. data/lib/generators/active_admin/install/templates/migrations/1_create_admin_notes.rb +16 -0
  247. data/lib/generators/active_admin/install/templates/migrations/2_move_admin_notes_to_comments.rb +25 -0
  248. data/lib/generators/active_admin/resource/resource_generator.rb +16 -0
  249. data/lib/generators/active_admin/resource/templates/admin.rb +3 -0
  250. data/script/local +44 -0
  251. data/script/use_rails +45 -0
  252. data/spec/integration/belongs_to_spec.rb +42 -0
  253. data/spec/integration/default_namespace.rb +77 -0
  254. data/spec/integration/javascript_spec.rb +20 -0
  255. data/spec/integration/stylesheets_spec.rb +41 -0
  256. data/spec/spec_helper.rb +157 -0
  257. data/spec/support/detect_rails_version.rb +11 -0
  258. data/spec/support/integration_example_group.rb +33 -0
  259. data/spec/support/jslint.yml +80 -0
  260. data/spec/support/rails_template.rb +32 -0
  261. data/spec/support/rails_template_with_data.rb +33 -0
  262. data/spec/support/templates/cucumber.rb +24 -0
  263. data/spec/unit/abstract_view_factory_spec.rb +79 -0
  264. data/spec/unit/action_builder_spec.rb +88 -0
  265. data/spec/unit/application_spec.rb +78 -0
  266. data/spec/unit/arbre/html/context_spec.rb +22 -0
  267. data/spec/unit/arbre/html/element_finder_methods_spec.rb +54 -0
  268. data/spec/unit/arbre/html/element_spec.rb +224 -0
  269. data/spec/unit/arbre/html/tag_attributes_spec.rb +61 -0
  270. data/spec/unit/arbre/html/tag_spec.rb +63 -0
  271. data/spec/unit/arbre/html_spec.rb +210 -0
  272. data/spec/unit/asset_registration_spec.rb +37 -0
  273. data/spec/unit/auto_link_spec.rb +39 -0
  274. data/spec/unit/belongs_to_spec.rb +45 -0
  275. data/spec/unit/breadcrumbs_spec.rb +110 -0
  276. data/spec/unit/comments_spec.rb +57 -0
  277. data/spec/unit/component_spec.rb +18 -0
  278. data/spec/unit/controller_filters_spec.rb +34 -0
  279. data/spec/unit/csv_builder_spec.rb +83 -0
  280. data/spec/unit/dashboard_controller_spec.rb +26 -0
  281. data/spec/unit/dashboard_section_spec.rb +56 -0
  282. data/spec/unit/dashboards_spec.rb +59 -0
  283. data/spec/unit/display_name_spec.rb +29 -0
  284. data/spec/unit/event_spec.rb +41 -0
  285. data/spec/unit/filter_form_builder_spec.rb +182 -0
  286. data/spec/unit/form_builder_spec.rb +239 -0
  287. data/spec/unit/generators/install_rails_3_1_spec.rb +16 -0
  288. data/spec/unit/helpers/settings_spec.rb +30 -0
  289. data/spec/unit/menu_item_spec.rb +143 -0
  290. data/spec/unit/menu_spec.rb +53 -0
  291. data/spec/unit/namespace_spec.rb +214 -0
  292. data/spec/unit/pretty_format_spec.rb +35 -0
  293. data/spec/unit/rails_spec.rb +43 -0
  294. data/spec/unit/registration_spec.rb +76 -0
  295. data/spec/unit/reloader_spec.rb +28 -0
  296. data/spec/unit/renderer_spec.rb +108 -0
  297. data/spec/unit/resource/action_items_spec.rb +62 -0
  298. data/spec/unit/resource/menu_spec.rb +80 -0
  299. data/spec/unit/resource/naming_spec.rb +56 -0
  300. data/spec/unit/resource/scopes_spec.rb +30 -0
  301. data/spec/unit/resource/sidebars_spec.rb +50 -0
  302. data/spec/unit/resource_controller/collection_spec.rb +34 -0
  303. data/spec/unit/resource_controller_spec.rb +152 -0
  304. data/spec/unit/resource_spec.rb +260 -0
  305. data/spec/unit/routing_spec.rb +88 -0
  306. data/spec/unit/sass/helpers_spec.rb +47 -0
  307. data/spec/unit/scope_spec.rb +31 -0
  308. data/spec/unit/tabs_renderer_spec.rb +85 -0
  309. data/spec/unit/view_factory_spec.rb +19 -0
  310. data/spec/unit/views/components/attributes_table_spec.rb +100 -0
  311. data/spec/unit/views/components/blank_slate_spec.rb +31 -0
  312. data/spec/unit/views/components/columns_spec.rb +75 -0
  313. data/spec/unit/views/components/panel_spec.rb +31 -0
  314. data/spec/unit/views/components/sidebar_section_spec.rb +37 -0
  315. data/spec/unit/views/components/status_tag_spec.rb +81 -0
  316. data/spec/unit/views/components/table_for_spec.rb +130 -0
  317. data/spec/unit/views/pages/layout_spec.rb +22 -0
  318. data/tasks/docs.rake +39 -0
  319. data/tasks/test.rake +49 -0
  320. data/tasks/yard.rake +6 -0
  321. metadata +510 -0
@@ -0,0 +1 @@
1
+ render renderer_for(:edit)
@@ -0,0 +1,20 @@
1
+ <%-
2
+ csv_lib = if RUBY_VERSION =~ /^1.8/
3
+ require 'fastercsv'
4
+ FasterCSV
5
+ else
6
+ require 'csv'
7
+ CSV
8
+ end
9
+
10
+ csv_output = csv_lib.generate do |csv|
11
+ columns = active_admin_config.csv_builder.columns
12
+ csv << columns.map(&:name)
13
+ collection.each do |resource|
14
+ csv << columns.map do |column|
15
+ call_method_or_proc_on resource, column.data
16
+ end
17
+ end
18
+ end
19
+ %>
20
+ <%= csv_output.html_safe %>
@@ -0,0 +1 @@
1
+ render renderer_for(:index)
@@ -0,0 +1 @@
1
+ render renderer_for(:new)
@@ -0,0 +1 @@
1
+ render renderer_for(:show)
@@ -0,0 +1 @@
1
+ render view_factory.layout
@@ -0,0 +1,35 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta http-equiv="Content-type" content="text/html; charset=utf-8">
5
+
6
+ <title><%= [@page_title, active_admin_application.site_title].join(" | ") %></title>
7
+
8
+ <% ActiveAdmin.application.stylesheets.each do |path| %>
9
+ <%= stylesheet_link_tag path %>
10
+ <% end %>
11
+ <% ActiveAdmin.application.javascripts.each do |path| %>
12
+ <%= javascript_include_tag path %>
13
+ <% end %>
14
+
15
+ <%= csrf_meta_tag %>
16
+ </head>
17
+ <body class="logged_out <%= controller.action_name %>">
18
+ <div id="wrapper">
19
+
20
+ <div id="content_wrapper">
21
+ <% if flash.keys.any? %>
22
+ <% flash.each do |type, message| %>
23
+ <%= content_tag :div, message, :class => "flash flash_#{type}" %>
24
+ <% end %>
25
+ <% end %>
26
+ <div id="active_admin_content">
27
+ <%= yield %>
28
+ </div>
29
+ </div>
30
+ <div id="footer">
31
+ <%= yield :footer %>
32
+ </div>
33
+ </div>
34
+ </body>
35
+ </html>
data/cucumber.yml ADDED
@@ -0,0 +1,2 @@
1
+ default: --format 'progress' --require features/support/env.rb --require features/step_definitions features
2
+ wip: --format 'progress' --require features/support/env.rb --require features/step_definitions features --tags @wip:3 --wip features
@@ -0,0 +1,52 @@
1
+ # General Configuration
2
+
3
+ ## Admin Users
4
+
5
+ By default Active Admin will include Devise and create a new model called
6
+ AdminUser. If you would like to use another name, you can pass it in to the
7
+ installer through the user option:
8
+
9
+ $> rails generate active_admin:install UserClassName
10
+
11
+ If you don't want the generator to create any user classes:
12
+
13
+ $> rails generate active_admin:install --skip-users
14
+
15
+ ## Authentication
16
+
17
+ Active Admin requires two settings to authenticate and use the current user
18
+ within your application. Both are set in
19
+ <tt>config/initializers/active_admin.rb</tt>. By default they are setup for use
20
+ with Devise and a model named AdminUser. If you chose a different model name,
21
+ you will need to update these settings.
22
+
23
+ Set the method that controllers should call to authenticate the current user
24
+ with:
25
+
26
+ # config/initializers/active_admin.rb
27
+ config.authentication_method = :authenticate_admin_user!
28
+
29
+ Set the method to call within the view to access the current admin user
30
+
31
+ # config/initializers/active_admin.rb
32
+ config.current_user_method = :current_admin_user
33
+
34
+ Both of these settings can be set to false to turn off authentication.
35
+
36
+ # Turn off authentication all together
37
+ config.authentication_method = false
38
+ config.current_user_method = false
39
+
40
+ ## Site Title
41
+
42
+ You can update the title used for the site in the initializer also. By default
43
+ it is set to the name of your Rails.application class name.
44
+
45
+ # config/initializers/active_admin.rb
46
+ config.site_title = "My Admin Site"
47
+
48
+ ## Internationalization (I18n)
49
+
50
+ To internationalize Active Admin or to change default strings, you can copy
51
+ lib/active_admin/locales/en.yml to your application config/locales directory and
52
+ change its content. You can contribute to the project with your translations to!
@@ -0,0 +1,35 @@
1
+ # Customize The Resource
2
+
3
+ ## Rename the Resource
4
+
5
+ By default, any references to the resource (menu, routes, buttons, etc) in the
6
+ interface will use the name of the class. You can rename the resource by using
7
+ the <tt>:as</tt> option.
8
+
9
+ ActiveAdmin.register Post, :as => "Article"
10
+
11
+ The resource will then be available as /admin/articles
12
+
13
+ ## Customize the Navigation
14
+
15
+ The resource will be displayed in the global navigation by default.
16
+
17
+ To disable the resource from being displayed in the global navigation:
18
+
19
+ ActiveAdmin.register Post do
20
+ menu false
21
+ end
22
+
23
+ To change the name of the label in the menu:
24
+
25
+ ActiveAdmin.register Post do
26
+ menu :label => "My Posts"
27
+ end
28
+
29
+ To add the menu as a child of another menu:
30
+
31
+ ActiveAdmin.register Post do
32
+ menu :parent => "Blog"
33
+ end
34
+
35
+ This will create the menu item if it doesn't exist yet.
@@ -0,0 +1,55 @@
1
+ # Customizing the Index Page
2
+
3
+ Filtering and listing resources is one of the most important tasks for
4
+ administering a web application. Active Admin provides many different tools for
5
+ you to build a compelling interface into your data for the admin staff.
6
+
7
+ Built in, Active Admin has the following index renderers:
8
+
9
+ * *Table*: A table drawn with each row being a resource ([View Table Docs](3-index-pages/index-as-table.md))
10
+ * *Grid*: A set of rows and columns each cell being a resource ([View Grid Docs](3-index-pages/index-as-grid.md))
11
+ * *Blocks*: A set of rows (not tabular) each row being a resource ([View Blocks Docs](3-index-pages/index-as-blocks.md))
12
+ * *Blog*: A title and body content, similar to a blog index ([View Blog Docs](3-index-pages/index-as-blog.md))
13
+
14
+ All index pages also support scopes, filters, pagination, action items, and
15
+ sidebar sections.
16
+
17
+ ## Index Filters
18
+
19
+ By default the index screen includes a "Filters" sidebar on the right hand side
20
+ with a filter for each attribute of the registered model. You can customize the
21
+ filters that are displayed as well as the type of widgets they use.
22
+
23
+ To display a filter for an attribute, use the filter method
24
+
25
+ ActiveAdmin.register Post do
26
+ filter :title
27
+ end
28
+
29
+ Out of the box, Active Admin supports the following filter types:
30
+
31
+ * *:string* - A search field
32
+ * *:date_range* - A start and end date field with calendar inputs
33
+ * *:numeric* - A drop down for selecting "Equal To", "Greater Than" or "Less
34
+ Than" and an input for a value.
35
+ * *:select* - A drop down which filters based on a selected item in a collection
36
+ or all.
37
+ * *:check_boxes* - A list of check boxes users can turn on and off to filter
38
+
39
+ By default, Active Admin will pick the most relevant filter based on the
40
+ attribute type. You can force the type by passing the :as option.
41
+
42
+ filter :author, :as => :check_boxes
43
+
44
+ The :check_boxes and :select types accept options for the collection. By default
45
+ it attempts to create a collection based on an association. But you can pass in
46
+ the collection as a proc to be called at render time.
47
+
48
+ # Will call available
49
+ filter :author, :as => :check_boxes, :collection => proc { Author.all }
50
+
51
+ You can change the filter label by passing a label option:
52
+
53
+ filter :author, :label => 'Author'
54
+
55
+ By default, Active Admin will try to use ActiveModel I18n to determine the label.
@@ -0,0 +1,16 @@
1
+ <!-- Please don't edit this file. It will be clobbered. -->
2
+
3
+ # Index as a Block
4
+
5
+ If you want to fully customize the display of your resources on the index
6
+ screen, Index as a Block allows you to render a block of content for each
7
+ resource.
8
+
9
+ index :as => :block do |product|
10
+ div :for => product do
11
+ h2 auto_link(product.title)
12
+ div do
13
+ simple_format product.description
14
+ end
15
+ end
16
+ end
@@ -0,0 +1,61 @@
1
+ <!-- Please don't edit this file. It will be clobbered. -->
2
+
3
+ # Index as Blog
4
+
5
+ Render your index page as a set of posts. The post has two main options:
6
+ title and body.
7
+
8
+ index :as => :blog do
9
+ title :my_title # Calls #my_title on each resource
10
+ body :my_body # Calls #my_body on each resource
11
+ end
12
+
13
+ ## Post Title
14
+
15
+ The title is the content that will be rendered within a link to the
16
+ resource. There are two main ways to set the content for the title
17
+
18
+ First, you can pass in a method to be called on your
19
+ resource. For example:
20
+
21
+ index :as => :blog do
22
+ title :a_method_to_call
23
+ end
24
+
25
+ This will result in the title of the post being the return value of
26
+ Resource#a_method_to_call
27
+
28
+ Second, you can pass a block to the tile option which will then be
29
+ used as the contents fo the title. The resource being rendered
30
+ is passed in to the block. For Example:
31
+
32
+ index :as => :blog do
33
+ title do |post|
34
+ span post.title, :class => 'title'
35
+ span post.created_at, :class => 'created_at'
36
+ end
37
+ end
38
+
39
+ ## Post Body
40
+
41
+ The body is rendered underneath the title of each post. The same two
42
+ style of options work as the Post Title above.
43
+
44
+ Call a method on the resource as the body:
45
+
46
+ index :as => :blog do
47
+ title :my_title
48
+ body :my_body # Return value of #my_body will be the body
49
+ end
50
+
51
+ Or, render a block as the body:
52
+
53
+ index :as => :blog do
54
+ title :my_title
55
+ body do |post|
56
+ div truncate(post.title)
57
+ div :class => 'meta' do
58
+ span "Post in #{post.categories.join(', ')}"
59
+ end
60
+ end
61
+ end
@@ -0,0 +1,21 @@
1
+ <!-- Please don't edit this file. It will be clobbered. -->
2
+
3
+ # Index as a Grid
4
+
5
+ Sometimes you want to display the index screen for a set of resources as a grid
6
+ (possibly a grid of thumbnail images). To do so, use the :grid option for the
7
+ index block.
8
+
9
+ index :as => :grid do |product|
10
+ link_to(image_tag(product.image_path), admin_products_path(product))
11
+ end
12
+
13
+ The block is rendered within a cell in the grid once for each resource in the
14
+ collection. The resource is passed into the block for you to use in the view.
15
+
16
+ You can customize the number of colums that are rendered using the columns
17
+ option:
18
+
19
+ index :as => :grid, :columns => 5 do |product|
20
+ link_to(image_tag(product.image_path), admin_products_path(product))
21
+ end
@@ -0,0 +1,74 @@
1
+ <!-- Please don't edit this file. It will be clobbered. -->
2
+
3
+ # Index as a Table
4
+
5
+ By default, the index page is a table with each of the models content columns and links to
6
+ show, edit and delete the object. There are many ways to customize what gets
7
+ displayed.
8
+
9
+ ## Defining Columns
10
+
11
+ To display an attribute or a method on a resource, simply pass a symbol into the
12
+ column method:
13
+
14
+ index do
15
+ column :title
16
+ end
17
+
18
+ If the default title does not work for you, pass it as the first argument:
19
+
20
+ index do
21
+ column "My Custom Title", :title
22
+ end
23
+
24
+ Sometimes calling methods just isn't enough and you need to write some view
25
+ specific code. For example, say we wanted a colum called Title which holds a
26
+ link to the posts admin screen.
27
+
28
+ The column method accepts a block as an argument which will then be rendered
29
+ within the context of the view for each of the objects in the collection.
30
+
31
+ index do
32
+ column "Title" do |post|
33
+ link_to post.title, admin_post_path(post)
34
+ end
35
+ end
36
+
37
+ The block gets called once for each resource in the collection. The resource gets passed into
38
+ the block as an argument.
39
+
40
+
41
+ ## Sorting
42
+
43
+ When a column is generated from an Active Record attribute, the table is
44
+ sortable by default. If you are creating a custom column, you may need to give
45
+ Active Admin a hint for how to sort the table.
46
+
47
+ If a column is defined using a block, you must pass the key to turn on sorting. The key
48
+ is the attribute which gets used to sort objects using Active Record.
49
+
50
+ index do
51
+ column "Title", :sortable => :title do |post|
52
+ link_to post.title, admin_post_path(post)
53
+ end
54
+ end
55
+
56
+ You can turn off sorting on any column by passing false:
57
+
58
+ index do
59
+ column :title, :sortable => false
60
+ end
61
+
62
+ ## Showing and Hiding Columns
63
+
64
+ The entire index block is rendered within the context of the view, so you can
65
+ easily do things that show or hide columns based on the current context.
66
+
67
+ For example, if you were using CanCan:
68
+
69
+ index do
70
+ column :title, :sortable => false
71
+ if can? :manage, Post
72
+ column :some_secret_data
73
+ end
74
+ end
@@ -0,0 +1,14 @@
1
+ # Customizing the CSV format
2
+
3
+ Active Admin provides CSV file downloads on the index screen for each Resource.
4
+ By default it will render a CSV file with all the content columns of your
5
+ registered model.
6
+
7
+ Customizing the CSV format is as simple as customizing the index page.
8
+
9
+ ActiveAdmin.register Post do
10
+ csv do
11
+ column :title
12
+ column("Author") { |post| post.author.full_name }
13
+ end
14
+ end
data/docs/5-forms.md ADDED
@@ -0,0 +1,39 @@
1
+ # Customizing the Form
2
+
3
+ Active Admin gives complete control over the output of the form by creating a thin DSL on top of
4
+ the fabulous DSL created by Formtastic (http://github.com/justinfrench/formtastic).
5
+
6
+ ActiveAdmin.register Post do
7
+
8
+ form do |f|
9
+ f.inputs "Details" do
10
+ f.input :title
11
+ f.input :published_at, :label => "Publish Post At"
12
+ f.input :category
13
+ end
14
+ f.inputs "Content" do
15
+ f.input :body
16
+ end
17
+ f.buttons
18
+ end
19
+
20
+ end
21
+
22
+ Please view the documentation for Formtastic to see all the wonderful things you can do:
23
+ http://github.com/justinfrench/formtastic
24
+
25
+ If you require a more custom form than can be provided through the DSL, you can pass
26
+ a partial in to render the form yourself.
27
+
28
+ For example:
29
+
30
+ ActiveAdmin.register Post do
31
+ form :partial => "form"
32
+ end
33
+
34
+ Then implement app/views/admin/posts/_form.html.erb:
35
+
36
+ <%= semantic_form_for [:admin, @post] do |f| %>
37
+ <%= f.inputs :title, :body %>
38
+ <%= f.buttons :commit %>
39
+ <% end %>