zen 0.2.8 → 0.3b

Sign up to get free protection for your applications and to get access to all the features.
Files changed (422) hide show
  1. data/.gems +20 -0
  2. data/.mailmap +3 -2
  3. data/.rvmrc +1 -1
  4. data/.travis.yml +13 -2
  5. data/.yardopts +13 -0
  6. data/AUTHORS +1 -1
  7. data/README.md +115 -77
  8. data/Rakefile +6 -7
  9. data/bin/zen +12 -5
  10. data/guide/_static/categories/categories.png +0 -0
  11. data/guide/_static/categories/category_groups.png +0 -0
  12. data/guide/_static/categories/new_category.png +0 -0
  13. data/guide/_static/categories/new_category_group.png +0 -0
  14. data/guide/_static/comments/comments.png +0 -0
  15. data/guide/_static/comments/edit_comment.png +0 -0
  16. data/guide/_static/custom_fields/custom_field_groups.png +0 -0
  17. data/guide/_static/custom_fields/custom_field_types.png +0 -0
  18. data/guide/_static/custom_fields/custom_fields.png +0 -0
  19. data/guide/_static/custom_fields/edit_custom_field_general.png +0 -0
  20. data/guide/_static/custom_fields/edit_custom_field_group.png +0 -0
  21. data/guide/_static/custom_fields/edit_custom_field_settings.png +0 -0
  22. data/guide/_static/custom_fields/edit_custom_field_type.png +0 -0
  23. data/guide/_static/menus/edit_menu.png +0 -0
  24. data/guide/_static/menus/edit_menu_item.png +0 -0
  25. data/guide/_static/menus/menu_items.png +0 -0
  26. data/guide/_static/menus/menus.png +0 -0
  27. data/guide/_static/sections/edit_entry.png +0 -0
  28. data/guide/_static/sections/edit_entry_categories.png +0 -0
  29. data/guide/_static/sections/edit_entry_general.png +0 -0
  30. data/guide/_static/sections/edit_entry_meta.png +0 -0
  31. data/guide/_static/sections/edit_section_comments.png +0 -0
  32. data/guide/_static/sections/edit_section_general.png +0 -0
  33. data/guide/_static/sections/edit_section_groups.png +0 -0
  34. data/guide/_static/sections/entries.png +0 -0
  35. data/guide/_static/sections/sections.png +0 -0
  36. data/guide/_static/settings/overview_general.png +0 -0
  37. data/guide/_static/settings/overview_security.png +0 -0
  38. data/guide/_static/settings/overview_user.png +0 -0
  39. data/guide/_static/users/edit_user.png +0 -0
  40. data/guide/_static/users/edit_user_group.png +0 -0
  41. data/guide/_static/users/edit_user_group_permissions.png +0 -0
  42. data/guide/_static/users/edit_user_permissions.png +0 -0
  43. data/guide/_static/users/overview.png +0 -0
  44. data/guide/_static/users/user_groups_overview.png +0 -0
  45. data/guide/asset_management.md +117 -0
  46. data/{CHANGELOG.md → guide/changelog.md} +42 -0
  47. data/guide/css/common.css +20 -0
  48. data/guide/getting_started.md +61 -0
  49. data/guide/hacking.md +52 -0
  50. data/guide/installation.md +44 -0
  51. data/guide/javascript.md +352 -0
  52. data/lib/vendor/sequel_sluggable.rb +137 -0
  53. data/lib/yard/tags.rb +13 -0
  54. data/lib/zen.rb +148 -78
  55. data/lib/zen/asset_groups.rb +85 -0
  56. data/lib/zen/bin/create.rb +267 -56
  57. data/lib/zen/bin/default.rb +84 -0
  58. data/lib/zen/controller/admin_controller.rb +1 -82
  59. data/lib/zen/controller/base_controller.rb +9 -5
  60. data/lib/zen/controller/frontend_controller.rb +0 -1
  61. data/lib/zen/controller/main_controller.rb +30 -42
  62. data/lib/zen/controller/preview.rb +9 -8
  63. data/lib/zen/controller/translations.rb +49 -0
  64. data/lib/zen/error.rb +17 -0
  65. data/lib/zen/event.rb +118 -0
  66. data/lib/zen/helper/asset.rb +63 -0
  67. data/lib/zen/helper/breadcrumb.rb +1 -4
  68. data/lib/zen/helper/controller.rb +73 -0
  69. data/lib/zen/helper/locale.rb +42 -0
  70. data/lib/zen/helper/message.rb +0 -3
  71. data/lib/zen/helper/search.rb +54 -0
  72. data/lib/zen/helper/stacked_aspect.rb +249 -0
  73. data/lib/zen/helper/theme.rb +3 -10
  74. data/lib/zen/language.rb +356 -181
  75. data/lib/zen/language/en/zen_general.rb +52 -0
  76. data/lib/zen/language/en/zen_models.rb +19 -0
  77. data/lib/zen/language/nl/zen_general.rb +57 -0
  78. data/lib/zen/language/nl/zen_models.rb +22 -0
  79. data/lib/zen/language/translation.rb +132 -0
  80. data/lib/zen/languages.rb +9 -0
  81. data/lib/zen/layout/admin.xhtml +3 -3
  82. data/lib/zen/layout/login.xhtml +1 -1
  83. data/lib/zen/markup.rb +189 -0
  84. data/lib/zen/model/helper.rb +65 -0
  85. data/lib/zen/model/init.rb +62 -0
  86. data/lib/zen/model/methods.rb +6 -7
  87. data/lib/zen/package.rb +312 -201
  88. data/lib/zen/package/all.rb +4 -3
  89. data/lib/zen/package/categories/lib/categories.rb +29 -41
  90. data/lib/zen/package/categories/lib/categories/controller/categories.rb +185 -130
  91. data/lib/zen/package/categories/lib/categories/controller/category_groups.rb +172 -102
  92. data/lib/zen/package/categories/lib/categories/helper/category.rb +4 -9
  93. data/lib/zen/package/categories/lib/categories/helper/category_frontend.rb +86 -0
  94. data/lib/zen/package/categories/lib/categories/language/en/categories.rb +40 -0
  95. data/lib/zen/package/categories/lib/categories/language/en/category_groups.rb +39 -0
  96. data/lib/zen/package/categories/lib/categories/language/nl/categories.rb +42 -0
  97. data/lib/zen/package/categories/lib/categories/language/nl/category_groups.rb +42 -0
  98. data/lib/zen/package/categories/lib/categories/model/category.rb +21 -25
  99. data/lib/zen/package/categories/lib/categories/model/category_group.rb +21 -15
  100. data/lib/zen/package/categories/lib/categories/view/admin/categories/form.xhtml +25 -26
  101. data/lib/zen/package/categories/lib/categories/view/admin/categories/index.xhtml +24 -24
  102. data/lib/zen/package/categories/lib/categories/view/admin/category-groups/form.xhtml +18 -20
  103. data/lib/zen/package/categories/lib/categories/view/admin/category-groups/index.xhtml +21 -18
  104. data/lib/zen/package/comments/lib/comments.rb +30 -50
  105. data/lib/zen/package/comments/lib/comments/anti_spam.rb +138 -0
  106. data/lib/zen/package/comments/lib/comments/controller/comments.rb +159 -92
  107. data/lib/zen/package/comments/lib/comments/controller/comments_form.rb +122 -34
  108. data/lib/zen/package/comments/lib/comments/helper/comment.rb +0 -3
  109. data/lib/zen/package/comments/lib/comments/helper/comment_frontend.rb +90 -0
  110. data/lib/zen/package/comments/lib/comments/language/en/comments.rb +57 -0
  111. data/lib/zen/package/comments/lib/comments/language/nl/comments.rb +61 -0
  112. data/lib/zen/package/comments/lib/comments/model/comment.rb +147 -49
  113. data/lib/zen/package/comments/lib/comments/model/comment_status.rb +0 -2
  114. data/lib/zen/package/comments/lib/comments/view/admin/comments/form.xhtml +37 -40
  115. data/lib/zen/package/comments/lib/comments/view/admin/comments/index.xhtml +23 -42
  116. data/lib/zen/package/comments/migrations/1308774099_comment_status.rb +12 -4
  117. data/lib/zen/package/comments/migrations/1313851786_remove_defensio_signature.rb +11 -0
  118. data/lib/zen/package/custom_fields/lib/custom_fields.rb +40 -43
  119. data/lib/zen/package/custom_fields/lib/custom_fields/blue_form_parameters.rb +72 -17
  120. data/lib/zen/package/custom_fields/lib/custom_fields/controller/custom_field_groups.rb +154 -118
  121. data/lib/zen/package/custom_fields/lib/custom_fields/controller/custom_field_types.rb +147 -90
  122. data/lib/zen/package/custom_fields/lib/custom_fields/controller/custom_fields.rb +161 -131
  123. data/lib/zen/package/custom_fields/lib/custom_fields/helper/custom_field.rb +4 -9
  124. data/lib/zen/package/custom_fields/lib/custom_fields/language/en/custom_field_groups.rb +42 -0
  125. data/lib/zen/package/custom_fields/lib/custom_fields/language/en/custom_field_types.rb +51 -0
  126. data/lib/zen/package/custom_fields/lib/custom_fields/language/en/custom_fields.rb +60 -0
  127. data/lib/zen/package/custom_fields/lib/custom_fields/language/nl/custom_field_groups.rb +41 -0
  128. data/lib/zen/package/custom_fields/lib/custom_fields/language/nl/custom_field_types.rb +49 -0
  129. data/lib/zen/package/custom_fields/lib/custom_fields/language/nl/custom_fields.rb +61 -0
  130. data/lib/zen/package/custom_fields/lib/custom_fields/model/custom_field.rb +18 -23
  131. data/lib/zen/package/custom_fields/lib/custom_fields/model/custom_field_group.rb +20 -19
  132. data/lib/zen/package/custom_fields/lib/custom_fields/model/custom_field_method.rb +1 -3
  133. data/lib/zen/package/custom_fields/lib/custom_fields/model/custom_field_type.rb +19 -9
  134. data/lib/zen/package/custom_fields/lib/custom_fields/model/custom_field_value.rb +18 -15
  135. data/lib/zen/package/custom_fields/lib/custom_fields/view/admin/custom-field-groups/form.xhtml +18 -18
  136. data/lib/zen/package/custom_fields/lib/custom_fields/view/admin/custom-field-groups/index.xhtml +30 -24
  137. data/lib/zen/package/custom_fields/lib/custom_fields/view/admin/custom-field-types/form.xhtml +15 -10
  138. data/lib/zen/package/custom_fields/lib/custom_fields/view/admin/custom-field-types/index.xhtml +24 -19
  139. data/lib/zen/package/custom_fields/lib/custom_fields/view/admin/custom-fields/form.xhtml +18 -13
  140. data/lib/zen/package/custom_fields/lib/custom_fields/view/admin/custom-fields/index.xhtml +30 -20
  141. data/lib/zen/package/extensions/lib/extensions.rb +20 -0
  142. data/lib/zen/package/extensions/lib/extensions/controller/extensions.rb +41 -0
  143. data/lib/zen/package/extensions/lib/extensions/language/en/extensions.rb +23 -0
  144. data/lib/zen/package/extensions/lib/extensions/language/nl/extensions.rb +25 -0
  145. data/lib/zen/package/extensions/lib/extensions/view/admin/extensions/index.xhtml +86 -0
  146. data/lib/zen/package/menu.rb +109 -0
  147. data/lib/zen/package/menus/lib/menus.rb +25 -34
  148. data/lib/zen/package/menus/lib/menus/controller/menu_items.rb +143 -107
  149. data/lib/zen/package/menus/lib/menus/controller/menus.rb +166 -115
  150. data/lib/zen/package/menus/lib/menus/helper/menu.rb +2 -8
  151. data/lib/zen/package/menus/lib/menus/helper/menu_frontend.rb +114 -0
  152. data/lib/zen/package/menus/lib/menus/language/en/menu_items.rb +48 -0
  153. data/lib/zen/package/menus/lib/menus/language/en/menus.rb +48 -0
  154. data/lib/zen/package/menus/lib/menus/language/nl/menu_items.rb +48 -0
  155. data/lib/zen/package/menus/lib/menus/language/nl/menus.rb +50 -0
  156. data/lib/zen/package/menus/lib/menus/model/menu.rb +24 -17
  157. data/lib/zen/package/menus/lib/menus/model/menu_item.rb +37 -13
  158. data/lib/zen/package/menus/lib/menus/view/admin/menu-items/form.xhtml +32 -25
  159. data/lib/zen/package/menus/lib/menus/view/admin/menu-items/index.xhtml +23 -17
  160. data/lib/zen/package/menus/lib/menus/view/admin/menus/form.xhtml +31 -26
  161. data/lib/zen/package/menus/lib/menus/view/admin/menus/index.xhtml +20 -22
  162. data/lib/zen/package/sections/lib/sections.rb +25 -68
  163. data/lib/zen/package/sections/lib/sections/controller/section_entries.rb +178 -138
  164. data/lib/zen/package/sections/lib/sections/controller/sections.rb +173 -140
  165. data/lib/zen/package/sections/lib/sections/helper/section.rb +3 -6
  166. data/lib/zen/package/sections/lib/sections/helper/section_frontend.rb +146 -0
  167. data/lib/zen/package/sections/lib/sections/language/en/section_entries.rb +50 -0
  168. data/lib/zen/package/sections/lib/sections/language/en/sections.rb +55 -0
  169. data/lib/zen/package/sections/lib/sections/language/nl/section_entries.rb +50 -0
  170. data/lib/zen/package/sections/lib/sections/language/nl/sections.rb +55 -0
  171. data/lib/zen/package/sections/lib/sections/model/section.rb +36 -36
  172. data/lib/zen/package/sections/lib/sections/model/section_entry.rb +52 -59
  173. data/lib/zen/package/sections/lib/sections/model/section_entry_status.rb +2 -2
  174. data/lib/zen/package/sections/lib/sections/view/admin/form.xhtml +24 -21
  175. data/lib/zen/package/sections/lib/sections/view/admin/index.xhtml +24 -26
  176. data/lib/zen/package/sections/lib/sections/view/admin/section-entries/form.xhtml +33 -31
  177. data/lib/zen/package/sections/lib/sections/view/admin/section-entries/index.xhtml +24 -25
  178. data/lib/zen/package/sections/migrations/1308672298_use_id_for_default_section.rb +14 -10
  179. data/lib/zen/package/sections/migrations/1308813320_section_entry_statuses.rb +12 -6
  180. data/lib/zen/package/settings/lib/settings.rb +25 -120
  181. data/lib/zen/package/settings/lib/settings/blue_form_parameters.rb +157 -0
  182. data/lib/zen/package/settings/lib/settings/controller/settings.rb +94 -69
  183. data/lib/zen/package/settings/lib/settings/language/en/settings.rb +41 -0
  184. data/lib/zen/package/settings/lib/settings/language/nl/settings.rb +41 -0
  185. data/lib/zen/package/settings/lib/settings/model/setting.rb +0 -2
  186. data/lib/zen/package/settings/lib/settings/setting.rb +379 -0
  187. data/lib/zen/package/settings/lib/settings/setting_groups.rb +11 -0
  188. data/lib/zen/package/settings/lib/settings/settings.rb +83 -0
  189. data/lib/zen/package/settings/lib/settings/settings_group.rb +84 -0
  190. data/lib/zen/package/settings/lib/settings/singleton_methods.rb +35 -0
  191. data/lib/zen/package/settings/lib/settings/view/admin/settings/index.xhtml +15 -57
  192. data/lib/zen/package/settings/migrations/1321197919_remove_unused_columns.rb +17 -0
  193. data/lib/zen/package/users/lib/users.rb +51 -36
  194. data/lib/zen/package/users/lib/users/controller/user_groups.rb +133 -98
  195. data/lib/zen/package/users/lib/users/controller/users.rb +253 -136
  196. data/lib/zen/package/users/lib/users/helper/access.rb +102 -0
  197. data/lib/zen/package/users/lib/users/helper/acl.rb +113 -0
  198. data/lib/zen/package/users/lib/users/helper/users.rb +41 -24
  199. data/lib/zen/package/users/lib/users/language/en/permissions.rb +16 -0
  200. data/lib/zen/package/users/lib/users/language/en/user_groups.rb +39 -0
  201. data/lib/zen/package/users/lib/users/language/en/users.rb +73 -0
  202. data/lib/zen/package/users/lib/users/language/nl/permissions.rb +16 -0
  203. data/lib/zen/package/users/lib/users/language/nl/user_groups.rb +41 -0
  204. data/lib/zen/package/users/lib/users/language/nl/users.rb +74 -0
  205. data/lib/zen/package/users/lib/users/model/permission.rb +28 -0
  206. data/lib/zen/package/users/lib/users/model/user.rb +104 -65
  207. data/lib/zen/package/users/lib/users/model/user_group.rb +28 -24
  208. data/lib/zen/package/users/lib/users/model/user_status.rb +27 -0
  209. data/lib/zen/package/users/lib/users/public/admin/css/users/permissions.css +22 -0
  210. data/lib/zen/package/users/lib/users/public/admin/js/users/permissions.js +33 -0
  211. data/lib/zen/package/users/lib/users/settings.rb +19 -0
  212. data/lib/zen/package/users/lib/users/view/admin/user-groups/form.xhtml +58 -28
  213. data/lib/zen/package/users/lib/users/view/admin/user-groups/index.xhtml +19 -15
  214. data/lib/zen/package/users/lib/users/view/admin/users/form.xhtml +93 -62
  215. data/lib/zen/package/users/lib/users/view/admin/users/index.xhtml +23 -36
  216. data/lib/zen/package/users/lib/users/view/admin/users/login.xhtml +13 -6
  217. data/lib/zen/package/users/lib/users/view/admin/users/permissions.xhtml +33 -0
  218. data/lib/zen/package/users/lib/users/view/admin/users/register.xhtml +52 -0
  219. data/lib/zen/package/users/migrations/1313786058_update_default_date.rb +41 -0
  220. data/lib/zen/package/users/migrations/1316432327_permissions.rb +36 -0
  221. data/lib/zen/package/users/migrations/1320272365_status_ids.rb +67 -0
  222. data/lib/zen/public/admin/css/zen/buttons.css +3 -11
  223. data/lib/zen/public/admin/css/zen/datepicker.css +23 -13
  224. data/lib/zen/public/admin/css/zen/editor.css +6 -14
  225. data/lib/zen/public/admin/css/zen/forms.css +19 -12
  226. data/lib/zen/public/admin/css/zen/general.css +22 -18
  227. data/lib/zen/public/admin/css/zen/grid.css +1 -20
  228. data/lib/zen/public/admin/css/zen/layout.css +26 -11
  229. data/lib/zen/public/admin/css/zen/messages.css +3 -10
  230. data/lib/zen/public/admin/css/zen/reset.css +13 -15
  231. data/lib/zen/public/admin/css/zen/tables.css +8 -10
  232. data/lib/zen/public/admin/css/zen/tabs.css +2 -10
  233. data/lib/zen/public/admin/css/zen/window.css +2 -8
  234. data/lib/zen/public/admin/js/vendor/datepicker.js +540 -240
  235. data/lib/zen/public/admin/js/vendor/mootools/core.js +273 -283
  236. data/lib/zen/public/admin/js/vendor/mootools/more.js +131 -136
  237. data/lib/zen/public/admin/js/zen/index.js +8 -14
  238. data/lib/zen/public/admin/js/zen/lib/editor.js +36 -33
  239. data/lib/zen/public/admin/js/zen/lib/editor/markdown.js +0 -6
  240. data/lib/zen/public/admin/js/zen/lib/editor/textile.js +0 -6
  241. data/lib/zen/public/admin/js/zen/lib/html_table.js +0 -5
  242. data/lib/zen/public/admin/js/zen/lib/tabs.js +22 -79
  243. data/lib/zen/public/admin/js/zen/lib/window.js +12 -22
  244. data/lib/zen/spec/bacon/color_output.rb +1 -1
  245. data/lib/zen/spec/helper.rb +6 -11
  246. data/lib/zen/spec/simplecov.rb +3 -3
  247. data/lib/zen/task.rb +0 -1
  248. data/lib/zen/task/build.rake +46 -26
  249. data/lib/zen/task/clean.rake +14 -7
  250. data/lib/zen/task/db.rake +31 -29
  251. data/lib/zen/task/package.rake +19 -23
  252. data/lib/zen/task/proto.rake +3 -5
  253. data/lib/zen/task/setup.rake +4 -0
  254. data/lib/zen/task/test.rake +31 -6
  255. data/lib/zen/task/theme.rake +13 -19
  256. data/lib/zen/theme.rb +377 -52
  257. data/lib/zen/validation.rb +22 -30
  258. data/lib/zen/version.rb +1 -2
  259. data/lib/zen/view/bottom.xhtml +9 -1
  260. data/lib/zen/view/head.xhtml +1 -1
  261. data/lib/zen/view/main.xhtml +1 -1
  262. data/lib/zen/view/search.xhtml +9 -0
  263. data/proto/app/Rakefile +0 -1
  264. data/proto/app/app.rb +21 -16
  265. data/proto/app/config/config.rb.erb +41 -0
  266. data/proto/app/config/{database.rb → database.rb.erb} +17 -14
  267. data/proto/app/config/middlewares.rb +1 -1
  268. data/proto/app/theme/default/index.xhtml +25 -0
  269. data/proto/app/theme/theme.rb +19 -0
  270. data/proto/app/{log/database/dev → tmp}/.gitkeep +0 -0
  271. data/proto/migration.rb +3 -5
  272. data/proto/rack/thin.yml +41 -0
  273. data/proto/rack/unicorn.rb +38 -0
  274. data/spec/Rakefile +15 -11
  275. data/spec/fixtures/zen/helper/controller.rb +13 -0
  276. data/spec/fixtures/zen/helper/locale.rb +7 -0
  277. data/spec/fixtures/zen/helper/message.rb +0 -4
  278. data/spec/fixtures/zen/language.rb +31 -0
  279. data/spec/fixtures/zen/language/en/spec.rb +11 -0
  280. data/spec/fixtures/zen/language/nl/spec.rb +11 -0
  281. data/spec/fixtures/zen/package.rb +0 -10
  282. data/spec/fixtures/zen/package/categories/helper/category_frontend.rb +16 -0
  283. data/spec/fixtures/zen/package/comments/helper/comment_frontend.rb +16 -0
  284. data/spec/fixtures/zen/package/sections/helper/section_frontend.rb +16 -0
  285. data/spec/fixtures/zen/package/settings/controller/settings.rb +17 -0
  286. data/spec/fixtures/zen/package/users/helper/access.rb +18 -0
  287. data/spec/fixtures/zen/package/users/helper/acl.rb +23 -0
  288. data/spec/fixtures/zen/theme/{default-section → default}/index.xhtml +0 -0
  289. data/spec/helper.rb +12 -27
  290. data/{proto/app/log/database/live → spec/public}/.gitkeep +0 -0
  291. data/spec/zen/controller/admin_controller.rb +5 -6
  292. data/spec/zen/controller/main_controller.rb +29 -35
  293. data/spec/zen/controller/preview.rb +9 -10
  294. data/spec/zen/event.rb +44 -0
  295. data/spec/zen/helper/breadcrumb.rb +4 -5
  296. data/spec/zen/helper/controller.rb +21 -0
  297. data/spec/zen/helper/locale.rb +25 -0
  298. data/spec/zen/helper/message.rb +4 -11
  299. data/spec/zen/helper/theme.rb +11 -14
  300. data/spec/zen/language.rb +48 -22
  301. data/spec/zen/markup.rb +39 -0
  302. data/spec/zen/package.rb +48 -11
  303. data/spec/zen/package/categories/controller/categories.rb +99 -45
  304. data/spec/zen/package/categories/controller/category_groups.rb +109 -33
  305. data/spec/zen/package/categories/helper/category.rb +19 -32
  306. data/spec/zen/package/categories/helper/category_frontend.rb +61 -0
  307. data/spec/zen/package/comments/anti_spam.rb +50 -0
  308. data/spec/zen/package/comments/controller/comments.rb +121 -61
  309. data/spec/zen/package/comments/controller/comments_form.rb +120 -94
  310. data/spec/zen/package/comments/helper/comment.rb +13 -13
  311. data/spec/zen/package/comments/helper/comment_frontend.rb +92 -0
  312. data/spec/zen/package/custom_fields/blue_form_parameters.rb +50 -50
  313. data/spec/zen/package/custom_fields/controller/custom_field_groups.rb +135 -43
  314. data/spec/zen/package/custom_fields/controller/custom_field_types.rb +153 -48
  315. data/spec/zen/package/custom_fields/controller/custom_fields.rb +130 -51
  316. data/spec/zen/package/custom_fields/helper/custom_field.rb +8 -8
  317. data/spec/zen/package/extensions/controller/extensions.rb +38 -0
  318. data/spec/zen/package/menus/controller/menu_items.rb +121 -42
  319. data/spec/zen/package/menus/controller/menus.rb +125 -38
  320. data/spec/zen/package/menus/helper/menu.rb +26 -26
  321. data/spec/zen/package/menus/helper/menu_frontend.rb +104 -0
  322. data/spec/zen/package/sections/controller/section_entries.rb +145 -89
  323. data/spec/zen/package/sections/controller/sections.rb +130 -35
  324. data/spec/zen/package/sections/helper/section.rb +27 -38
  325. data/spec/zen/package/sections/helper/section_frontend.rb +160 -0
  326. data/spec/zen/package/settings/controller/settings.rb +73 -8
  327. data/spec/zen/package/settings/settings.rb +119 -0
  328. data/spec/zen/package/users/controller/user_groups.rb +134 -34
  329. data/spec/zen/package/users/controller/users.rb +189 -44
  330. data/spec/zen/package/users/helper/access.rb +29 -0
  331. data/spec/zen/package/users/helper/acl.rb +46 -0
  332. data/spec/zen/package/users/helper/users.rb +20 -64
  333. data/spec/zen/theme.rb +7 -9
  334. data/spec/zen/validation.rb +1 -2
  335. data/zen.gemspec +25 -22
  336. metadata +303 -222
  337. data/lib/zen/asset.rb +0 -292
  338. data/lib/zen/bin/runner.rb +0 -118
  339. data/lib/zen/error/language_error.rb +0 -10
  340. data/lib/zen/error/package_error.rb +0 -10
  341. data/lib/zen/error/plugin_error.rb +0 -10
  342. data/lib/zen/error/theme_error.rb +0 -10
  343. data/lib/zen/error/validation_error.rb +0 -10
  344. data/lib/zen/helper/acl.rb +0 -182
  345. data/lib/zen/helper/blue_form_vendor.rb +0 -689
  346. data/lib/zen/language/en/zen_general.yml +0 -25
  347. data/lib/zen/language/en/zen_models.yml +0 -13
  348. data/lib/zen/language/nl/zen_general.yml +0 -25
  349. data/lib/zen/language/nl/zen_models.yml +0 -13
  350. data/lib/zen/model/settings.rb +0 -78
  351. data/lib/zen/package/base.rb +0 -62
  352. data/lib/zen/package/categories/lib/categories/language/en/categories.yml +0 -36
  353. data/lib/zen/package/categories/lib/categories/language/en/category_groups.yml +0 -34
  354. data/lib/zen/package/categories/lib/categories/language/nl/categories.yml +0 -40
  355. data/lib/zen/package/categories/lib/categories/language/nl/category_groups.yml +0 -34
  356. data/lib/zen/package/categories/lib/categories/plugin/categories.rb +0 -141
  357. data/lib/zen/package/comments/lib/comments/language/en/comments.yml +0 -48
  358. data/lib/zen/package/comments/lib/comments/language/nl/comments.yml +0 -50
  359. data/lib/zen/package/comments/lib/comments/plugin/anti_spam.rb +0 -156
  360. data/lib/zen/package/comments/lib/comments/plugin/comments.rb +0 -115
  361. data/lib/zen/package/custom_fields/lib/custom_fields/language/en/custom_field_groups.yml +0 -33
  362. data/lib/zen/package/custom_fields/lib/custom_fields/language/en/custom_field_types.yml +0 -40
  363. data/lib/zen/package/custom_fields/lib/custom_fields/language/en/custom_fields.yml +0 -54
  364. data/lib/zen/package/custom_fields/lib/custom_fields/language/nl/custom_field_groups.yml +0 -33
  365. data/lib/zen/package/custom_fields/lib/custom_fields/language/nl/custom_field_types.yml +0 -40
  366. data/lib/zen/package/custom_fields/lib/custom_fields/language/nl/custom_fields.yml +0 -54
  367. data/lib/zen/package/menus/lib/menus/language/en/menu_items.yml +0 -41
  368. data/lib/zen/package/menus/lib/menus/language/en/menus.yml +0 -40
  369. data/lib/zen/package/menus/lib/menus/language/nl/menu_items.yml +0 -41
  370. data/lib/zen/package/menus/lib/menus/language/nl/menus.yml +0 -40
  371. data/lib/zen/package/menus/lib/menus/plugin/menus.rb +0 -152
  372. data/lib/zen/package/sections/lib/sections/language/en/section_entries.yml +0 -44
  373. data/lib/zen/package/sections/lib/sections/language/en/sections.yml +0 -48
  374. data/lib/zen/package/sections/lib/sections/language/nl/section_entries.yml +0 -44
  375. data/lib/zen/package/sections/lib/sections/language/nl/sections.yml +0 -48
  376. data/lib/zen/package/sections/lib/sections/plugin/section_entries.rb +0 -244
  377. data/lib/zen/package/sections/lib/sections/plugin/sections.rb +0 -87
  378. data/lib/zen/package/settings/lib/settings/language/en/settings.yml +0 -36
  379. data/lib/zen/package/settings/lib/settings/language/nl/settings.yml +0 -37
  380. data/lib/zen/package/settings/lib/settings/plugin/group_base.rb +0 -39
  381. data/lib/zen/package/settings/lib/settings/plugin/setting_base.rb +0 -133
  382. data/lib/zen/package/settings/lib/settings/plugin/settings.rb +0 -251
  383. data/lib/zen/package/users/lib/users/controller/access_rules.rb +0 -284
  384. data/lib/zen/package/users/lib/users/language/en/access_rules.yml +0 -38
  385. data/lib/zen/package/users/lib/users/language/en/user_groups.yml +0 -32
  386. data/lib/zen/package/users/lib/users/language/en/users.yml +0 -57
  387. data/lib/zen/package/users/lib/users/language/nl/access_rules.yml +0 -38
  388. data/lib/zen/package/users/lib/users/language/nl/user_groups.yml +0 -32
  389. data/lib/zen/package/users/lib/users/language/nl/users.yml +0 -57
  390. data/lib/zen/package/users/lib/users/model/access_rule.rb +0 -42
  391. data/lib/zen/package/users/lib/users/public/admin/js/users/access_rules.js +0 -65
  392. data/lib/zen/package/users/lib/users/public/admin/js/users/lib/access_rules.js +0 -49
  393. data/lib/zen/package/users/lib/users/view/admin/access-rules/form.xhtml +0 -120
  394. data/lib/zen/package/users/lib/users/view/admin/access-rules/index.xhtml +0 -102
  395. data/lib/zen/plugin.rb +0 -182
  396. data/lib/zen/plugin/base.rb +0 -46
  397. data/lib/zen/plugin/helper.rb +0 -47
  398. data/lib/zen/plugin/markup/lib/markup.rb +0 -14
  399. data/lib/zen/plugin/markup/lib/markup/language/en/markup.yml +0 -6
  400. data/lib/zen/plugin/markup/lib/markup/markup.rb +0 -165
  401. data/lib/zen/public/admin/js/zen/lib/asset.js +0 -111
  402. data/lib/zen/task/plugin.rake +0 -18
  403. data/lib/zen/theme/base.rb +0 -65
  404. data/proto/app/config/config.rb +0 -18
  405. data/spec/fixtures/zen/language/en/spec.yml +0 -10
  406. data/spec/fixtures/zen/language/nl/spec.yml +0 -7
  407. data/spec/fixtures/zen/package/settings/plugin/settings.rb +0 -20
  408. data/spec/zen/asset.rb +0 -97
  409. data/spec/zen/bin/create.rb +0 -89
  410. data/spec/zen/bin/runner.rb +0 -47
  411. data/spec/zen/helper/acl.rb +0 -149
  412. data/spec/zen/package/categories/plugin/categories.rb +0 -92
  413. data/spec/zen/package/comments/plugin/anti_spam.rb +0 -59
  414. data/spec/zen/package/comments/plugin/comments.rb +0 -107
  415. data/spec/zen/package/menus/plugin/menus.rb +0 -120
  416. data/spec/zen/package/sections/plugin/section_entries.rb +0 -161
  417. data/spec/zen/package/sections/plugin/sections.rb +0 -75
  418. data/spec/zen/package/settings/plugin/settings.rb +0 -33
  419. data/spec/zen/package/users/controller/access_rules.rb +0 -90
  420. data/spec/zen/plugin.rb +0 -64
  421. data/spec/zen/plugin/helper.rb +0 -11
  422. data/spec/zen/plugin/markup.rb +0 -44
@@ -1,10 +0,0 @@
1
- #:nodoc:
2
- module Zen
3
- ##
4
- # Error class used by Zen::Validation.
5
- #
6
- # @author Yorick Peterse
7
- # @since 0.2.5
8
- #
9
- class ValidationError < StandardError; end
10
- end
@@ -1,182 +0,0 @@
1
- #:nodoc:
2
- module Ramaze
3
- #:nodoc:
4
- module Helper
5
- ##
6
- # This helper provides an easy way of working with the ACL system that ships
7
- # with Zen. Using this helper you can restrict access to methods, view
8
- # elements and pretty much everything else based on the user's permissions.
9
- #
10
- # In order to restrict certain actions to only those with the correct
11
- # permissions you can use the method "user_authorized?". This method takes
12
- # a list of required permissions and when the user has the correct
13
- # permissions it will return true:
14
- #
15
- # user_authorized?([:read]) # => true
16
- #
17
- # The method has 3 parameters: a list of permissions, a boolean that
18
- # indicates whether all of them or just a single one is required and a third
19
- # argument that can be used to manually specify the controller to validate
20
- # against rather than the current node.
21
- #
22
- # user_authorized?([:read], true 'FoobarController')
23
- #
24
- # @author Yorick Peterse
25
- # @since 0.1
26
- # @see Users::Controller::AccessRules()
27
- #
28
- module ACL
29
- ##
30
- # Builds a hash containing the permissions for all controllers. First all
31
- # group based rules will be retrieved. If the user is in a super group
32
- # he'll gain full access. However, if there's a user specific rule it will
33
- # overwrite the rules set for the group. This means that if a group allows
34
- # something but a user rule doesn't the user won't be able to gain access
35
- # to the resource.
36
- #
37
- # @author Yorick Peterse
38
- # @since 0.1
39
- # @return [Hash]
40
- #
41
- def extension_permissions
42
- return session[:access_rules] if session[:access_rules]
43
-
44
- user = session[:user]
45
- user_groups = user.user_groups
46
- @__used_rules = {}
47
- available_rules = [
48
- :create_access,
49
- :read_access,
50
- :update_access,
51
- :delete_access
52
- ]
53
-
54
- # First all group rules should be built
55
- user_groups.each do |group|
56
- # If it's a super group we'll add all rules
57
- if group.super_group === true
58
- ::Zen::Package::Controllers.each do |controller|
59
- @__used_rules[controller.to_s] = [
60
- :create,
61
- :read,
62
- :update,
63
- :delete
64
- ]
65
- end
66
- end
67
-
68
- group.access_rules.each do |rule|
69
- process_permissions(rule, available_rules)
70
- end
71
- end
72
-
73
- # Process all user specific rules
74
- user.access_rules.each do |rule|
75
- process_permissions(rule, available_rules)
76
- end
77
-
78
- # Store the rules in the user's session so that they don't have to be
79
- # re-processed every time this method is called.
80
- session[:access_rules] = @__used_rules
81
-
82
- return @__used_rules
83
- end
84
-
85
- ##
86
- # Checks if the user has the specified permissions for the current
87
- # extension that was called. Returns true if this is the case and false
88
- # otherwise.
89
- #
90
- # @author Yorick Peterse
91
- # @param [Array] required Array of permissions that are required.
92
- # @param [Boolean] require_all Boolean that specifies that the user
93
- # should have ALL specified permissios. Setting this to false causes this
94
- # method to return true if any of the permissions are set for the current
95
- # user.
96
- # @param [String] controller When set this will overwrite the controller
97
- # name of action.node. This is useful when you want to check the
98
- # permissions of a different controller than the current one.
99
- # @return [TrueClass/FalseClass]
100
- #
101
- def user_authorized?(required, require_all = true, controller = nil)
102
- rules = extension_permissions
103
- controller = action.node.to_s if !controller
104
-
105
- return false if !rules.key?(controller)
106
-
107
- required.each do |req|
108
- if require_all === false and rules[controller].include?(req)
109
- return true
110
- elsif !rules[controller].include?(req)
111
- return false
112
- end
113
- end
114
-
115
- return true
116
- end
117
-
118
- private
119
-
120
- ##
121
- # Extracts and stores all the permissions from a given rule.
122
- #
123
- # @author Yorick Peterse
124
- # @since 0.2.5
125
- # @param [Users::Model::AccessRule] rule Database record containing the
126
- # details of a single rule.
127
- # @param [Array] available_rules All the available rules that can be used.
128
- #
129
- def process_permissions(rule, available_rules)
130
- available_rules.each do |available_rule|
131
- # Add the rule to the list
132
- if rule.send(available_rule) === true
133
- method = :push
134
- # Remove the rule
135
- else
136
- method = :delete
137
- end
138
-
139
- available_rule = available_rule.to_s.gsub('_access', '').to_sym
140
- controllers = []
141
-
142
- # Process all controllers
143
- if rule.controller === '*'
144
- ::Zen::Package[rule.package].controllers.each do |name, controller|
145
- controllers.push(controller.to_s)
146
- end
147
- # Process a single controller
148
- else
149
- controllers.push(rule.controller)
150
- end
151
-
152
- # Add the rules for all the controllers
153
- controllers.each do |c|
154
- @__used_rules[c] ||= []
155
-
156
- if method === :push and @__used_rules[c].include?(available_rule)
157
- next
158
- end
159
-
160
- # Add or remove the permission
161
- @__used_rules[c].send(method, available_rule)
162
- end
163
- end
164
- end
165
-
166
- ##
167
- # Method that checks if the user has the given permissions. If this isn't
168
- # the case an error message is displayed and the user won't be able to
169
- # access the page.
170
- #
171
- # @author Yorick Peterse
172
- # @since 0.2.8
173
- # @param [Array] *args An array of permissions that are required.
174
- #
175
- def require_permissions(*args)
176
- if !user_authorized?(args)
177
- respond(lang('zen_general.errors.not_authorized'), 403)
178
- end
179
- end
180
- end # ACL
181
- end # Helper
182
- end # Ramaze
@@ -1,689 +0,0 @@
1
- require 'ramaze'
2
- require 'ramaze/gestalt'
3
-
4
- module Ramaze
5
- module Helper
6
- ##
7
- # == Introduction
8
- #
9
- # The BlueForm helper tries to be an even better way to build forms
10
- # programmatically. By using a simple block you can quickly create all the
11
- # required elements for your form.
12
- #
13
- # Since November 2010 the BlueForm helper works different. You can now
14
- # specify an object as the first parameter of the form_for() method. This
15
- # object will be used to retrieve the values of each field. This means that
16
- # you can directly pass a database result object to the form and no longer
17
- # have to manually specify values. However, you can still specify your own
18
- # values if you want.
19
- #
20
- # Old behaviour:
21
- #
22
- # form_for(:method => :post) do |f|
23
- # f.input_text 'Username', :username, 'Chuck Norris'
24
- # end
25
- #
26
- # New behaviour:
27
- #
28
- # # @data is an object that contains an instance variable named "username".
29
- # # This variable contains the value "Chuck Norris".
30
- # form_for(@data, :method => :post) do |f|
31
- # f.input_text 'Username', :username
32
- # end
33
- #
34
- # == Form Data
35
- #
36
- # As stated earlier it's possible to pass an object to the form_for()
37
- # method. What kind of object this is, a database result object or an
38
- # OpenStruct object doesn't matter as long as the attributes can be accessed
39
- # outside of the object (this can be done using attr_readers). This makes it
40
- # extremely easy to directly pass a result object from your favourite ORM.
41
- # Example:
42
- #
43
- # @data = User[1]
44
- #
45
- # form_for(@data, :method => :post) do |f|
46
- # f.input_text 'Username', :username
47
- # end
48
- #
49
- # If you don't want to use an object you can simply set the first parameter
50
- # to nil.
51
- #
52
- # == HTML Output
53
- #
54
- # The form helper uses Gestalt, Ramaze's custom HTML builder that works
55
- # somewhat like Erector. The output is very minimalistic, elements such as
56
- # legends and fieldsets have to be added manually. Each combination of a
57
- # label and input element will be wrapped in <p> tags.
58
- #
59
- # When using the form helper as a block in your templates it's important to
60
- # remember that the result is returned and not displayed in the browser
61
- # directly. When using Etanni this would result in something like the
62
- # following:
63
- #
64
- # #{
65
- # form_for(@result, :method => :post) do |f| do
66
- # f.input_text 'Text label', :textname, 'Chunky bacon!'
67
- # end
68
- # }
69
- #
70
- # @example
71
- #
72
- # form_for(@data, :method => :post) do |f|
73
- # f.input_text 'Username', :username
74
- # end
75
- #
76
- module BlueFormVendor
77
- ##
78
- # The form method generates the basic structure of the form. It should be
79
- # called using a block and it's return value should be manually sent to
80
- # the browser (since it does not echo the value).
81
- #
82
- # @param [Object] form_values Object containing the values for each form
83
- # field.
84
- # @param [Hash] options Hash containing any additional form attributes
85
- # such as the method, action, enctype and so on.
86
- # @param [Block] block Block containing the elements of the form such as
87
- # password fields, textareas and so on.
88
- #
89
- def form_for(form_values, options = {}, &block)
90
- form = Form.new(form_values, options)
91
- form.build(form_errors, &block)
92
- form
93
- end
94
-
95
- ##
96
- # Manually add a new error to the form_errors key in the flash hash. The
97
- # first parameter is the name of the form field and the second parameter
98
- # is the custom message.
99
- #
100
- # @param [String] name The name of the form field to which the error
101
- # belongs.
102
- # @param [String] message The custom error message to show.
103
- #
104
- def form_error(name, message)
105
- if respond_to?(:flash)
106
- old = flash[:form_errors] || {}
107
- flash[:form_errors] = old.merge(name.to_s => message.to_s)
108
- else
109
- form_errors[name.to_s] = message.to_s
110
- end
111
- end
112
-
113
- ##
114
- # Returns the hash containing all existing errors and allows other methods
115
- # to set new errors by using this method as if it were a hash.
116
- #
117
- # @return [Array] All form errors.
118
- #
119
- def form_errors
120
- if respond_to?(:flash)
121
- flash[:form_errors] ||= {}
122
- else
123
- @form_errors ||= {}
124
- end
125
- end
126
-
127
- ##
128
- # Retrieve all the form errors for the specified model and add them to the
129
- # flash hash.
130
- #
131
- # @param [Object] obj An object of a model that contains form errors.
132
- #
133
- def form_errors_from_model(obj)
134
- if obj.respond_to?(:errors)
135
- obj.errors.each do |key, value|
136
- if value.respond_to?(:first)
137
- value = value.first
138
- end
139
-
140
- form_error(key.to_s, value % key)
141
- end
142
- end
143
- end
144
-
145
- ##
146
- # Main form class that contains all the required methods to generate form
147
- # specific tags, such as textareas and select boxes. Do note that this
148
- # class is not thread-safe so you should modify it only within one thread
149
- # of execution.
150
- #
151
- class Form
152
- attr_reader :g
153
- attr_reader :form_values
154
-
155
- ##
156
- # Constructor method that generates an instance of the Form class.
157
- #
158
- # @param [Object] form_values Object containing the values for each form
159
- # field.
160
- # @param [Hash] options A hash containing any additional form attributes.
161
- # @return [Object] An instance of the Form class.
162
- #
163
- def initialize(form_values, options)
164
- @form_values = form_values
165
- @form_args = options.dup
166
- @g = Gestalt.new
167
- end
168
-
169
- ##
170
- # Builds the form by generating the opening/closing tags and executing
171
- # the methods in the block.
172
- #
173
- # @param [Hash] form_errors Hash containing all form errors (if any).
174
- #
175
- def build(form_errors = {})
176
- # Convert all the keys in form_errors to strings and
177
- # retrieve the correct values in case
178
- @form_errors = {}
179
-
180
- form_errors.each do |key, value|
181
- if value.respond_to?(:first)
182
- value = value.first
183
- end
184
-
185
- @form_errors[key.to_s] = value
186
- end
187
-
188
- @g.form(@form_args) do
189
- if block_given?
190
- yield self
191
- end
192
- end
193
- end
194
-
195
- ##
196
- # Generate a <legend> tag.
197
- #
198
- # @param [String] text The text to display inside the legend tag.
199
- # @example
200
- #
201
- # form_for(@data, :method => :post) do |f|
202
- # f.legend 'Ramaze rocks!'
203
- # end
204
- #
205
- def legend(text)
206
- @g.legend(text)
207
- end
208
-
209
- ##
210
- # Generate a fieldset tag.
211
- #
212
- # @param [Block] &block The form elements to display inside the fieldset.
213
- # @example
214
- #
215
- # form_for(@data, :method => :post) do |f|
216
- # f.fieldset do
217
- # f.legend 'Hello, world!'
218
- # end
219
- # end
220
- #
221
- def fieldset(&block)
222
- @g.fieldset(&block)
223
- end
224
-
225
- ##
226
- # Generate an input tag with a type of "text" along with a label tag.
227
- # This method also has the alias "text" so feel free to use that one
228
- # instead of input_text.
229
- #
230
- # @param [String] label The text to display inside the label tag.
231
- # @param [String Symbol] name The name of the text field.
232
- # @param [Hash] args Any additional HTML attributes along with their
233
- # values.
234
- # @example
235
- #
236
- # form_for(@data, :method => :post) do |f|
237
- # f.input_text 'Username', :username
238
- # end
239
- #
240
- def input_text(label, name, args = {})
241
- # The ID can come from 2 places, id_for and the args hash
242
- id = args[:id] ? args[:id] : id_for(name)
243
- args = args.merge(:type => :text, :name => name, :id => id)
244
-
245
- if !args[:value] and @form_values.respond_to?(name)
246
- args[:value] = @form_values.send(name)
247
- end
248
-
249
- @g.p do
250
- label_for(id, label, name)
251
- @g.input(args)
252
- end
253
- end
254
- alias text input_text
255
-
256
- ##
257
- # Generate an input tag with a type of "password" along with a label.
258
- # Password fields are pretty much the same as text fields except that
259
- # the content of these fields is replaced with dots. This method has the
260
- # following alias: "password".
261
- #
262
- # @param [String] label The text to display inside the label tag.
263
- # @param [String Symbol] name The name of the password field.
264
- # @param [Hash] args Any additional HTML attributes along with their
265
- # values.
266
- # @example
267
- #
268
- # form_for(@data, :method => :post) do |f|
269
- # f.input_password 'My password', :password
270
- # end
271
- #
272
- def input_password(label, name, args = {})
273
- # The ID can come from 2 places, id_for and the args hash
274
- id = args[:id] ? args[:id] : id_for(name)
275
- args = args.merge(:type => :password, :name => name, :id => id)
276
-
277
- if !args[:value] and @form_values.respond_to?(name)
278
- args[:value] = @form_values.send(name)
279
- end
280
-
281
- @g.p do
282
- label_for(id, label, name)
283
- @g.input(args)
284
- end
285
- end
286
- alias password input_password
287
-
288
- ##
289
- # Generate a submit tag (without a label). A submit tag is a button that
290
- # once it's clicked will send the form data to the server.
291
- #
292
- # @param [String] value The text to display in the button.
293
- # @param [Hash] args Any additional HTML attributes along with their
294
- # values.
295
- # @example
296
- #
297
- # form_for(@data, :method => :post) do |f|
298
- # f.input_submit 'Save'
299
- # end
300
- #
301
- def input_submit(value = nil, args = {})
302
- args = args.merge(:type => :submit)
303
- args[:value] = value unless value.nil?
304
-
305
- @g.p do
306
- @g.input(args)
307
- end
308
- end
309
- alias submit input_submit
310
-
311
- ##
312
- # Generate an input tag with a type of "checkbox".
313
- #
314
- # If you want to have multiple checkboxes you can either use an array or
315
- # a hash. In the case of an array the values will also be used as text
316
- # for each checkbox. When using a hash the key will be displayed and
317
- # the value will be the value of the checkbox. Example:
318
- #
319
- # @data = Class.new
320
- # attr_reader :gender_arr
321
- # attr_reader :gender_hash
322
- #
323
- # def initialize
324
- # @gender_arr = ['male', 'female']
325
- # @gender_hash = {"Male" => "male", "Female" => "female"}
326
- # end
327
- # end.new
328
- #
329
- # form_for(@data, :method => :post) do |f|
330
- # f.input_checkbox "Gender", :gender_arr
331
- # f.input_checkbox "Gender", :gender_hash
332
- # end
333
- #
334
- # @example
335
- # form_for(@data, :method => :post) do |f|
336
- # f.input_checkbox 'Remember me', :remember_user
337
- # end
338
- #
339
- # @param [String] label The text to display inside the label tag.
340
- # @param [String Symbol] name The name of the checkbox.
341
- # @param [String/Array] checked String or array that indicates which
342
- # value(s) should be checked.
343
- # @param [Hash] args Any additional HTML attributes along with their
344
- # values.
345
- # @option args [String/Symbol] :id The value to use for the ID attribute.
346
- # @option args [Array] :values An array containing the possible values
347
- # for the checkboxes.
348
- # @option args [String/Symbol] :span_class The class to use for the
349
- # <span> element that's wrapped around the checkbox.
350
- # @option args [TrueClass/FalseClass] :show_value When set to false the
351
- # value of each checkbox won't be displayed to the right of the
352
- # checkbox. This option is set to true by default.
353
- # @option args [TrueClass/FalseClass] :show_label When set to true
354
- # (default) the label for the checkbox will be displayed. Setting this
355
- # to false will hide it.
356
- #
357
- def input_checkbox(label, name, checked = nil, args = {})
358
- id = args[:id] ? args[:id] : "#{id_for(name)}_0"
359
-
360
- # Determine whether or not to show the value of the checkbox
361
- if args.key?(:show_value)
362
- show_value = args.delete(:show_value)
363
- else
364
- show_value = true
365
- end
366
-
367
- # Determine whether or not to show the label
368
- if args.key?(:show_label)
369
- show_label = args.delete(:show_label)
370
- else
371
- show_label = true
372
- end
373
-
374
- # Get the checkbox value from either the args hash or from
375
- # the form object (as specified in the form_for() method).
376
- if !args[:values] and @form_values.respond_to?(name)
377
- args[:values] = @form_values.send(name)
378
- end
379
-
380
- # That class for each element wrapper (a span tag) can be customized
381
- # using :span_class => "a_class".
382
- if args[:span_class]
383
- span_class = args[:span_class]
384
- args.delete(:span_class)
385
- else
386
- span_class = "checkbox_wrap"
387
- end
388
-
389
- # Get the type from the args hash instead of pre-defining it. Doing so
390
- # means we can use this method for the input_radio method.
391
- args[:type] = :checkbox if !args[:type]
392
-
393
- # Convert the values to an array if it's something we can't use in a loop
394
- # (e.g. a string).
395
- if args[:values].class != Hash and args[:values].class != Array
396
- args[:values] = [args[:values]]
397
- end
398
-
399
- # Create a checkbox for each value
400
- if !args[:values].empty?
401
- @g.p do
402
- # Let's create the label and the hidden field
403
- if show_label === true
404
- label_for(id, label, name)
405
- end
406
-
407
- # Loop through all the values. Each checkbox will have an ID of
408
- # "form-NAME-INDEX". Each name will be NAME followed by [] to
409
- # indicate it's an array (since multiple values are possible).
410
- args[:values].each_with_index do |value, index|
411
- id = args[:id] ? args[:id] : "#{id_for(name)}_#{index}"
412
-
413
- if args[:type] == :checkbox
414
- checkbox_name = "#{name}[]"
415
- else
416
- checkbox_name = name
417
- end
418
-
419
- # Copy all additional attributes and their values except the
420
- # values array.
421
- opts = args.clone
422
- opts.delete(:values)
423
-
424
- # Get the value and text to display for each checkbox
425
- if value.class == Array
426
- checkbox_text = value[0]
427
- checkbox_value = value[1]
428
- else
429
- checkbox_text = checkbox_value = value
430
- end
431
-
432
- # Let's see if the current item is checked
433
- if checked.class == Array
434
- if checked.include?(checkbox_value)
435
- opts[:checked] = 'checked'
436
- end
437
- else
438
- if checkbox_value == checked
439
- opts[:checked] = 'checked'
440
- end
441
- end
442
-
443
- # And we're done, easy wasn't it?
444
- opts = opts.merge(
445
- :name => checkbox_name, :id => id, :value => checkbox_value
446
- )
447
-
448
- # Generate the following HTML:
449
- #
450
- # <span class="#{span_class}">
451
- # <input type="checkbox" name="#{checkbox_name}" id="#{id}"
452
- # value="#{value}" /> #{value}
453
- # </span>
454
- #
455
- @g.span(:class => span_class) do
456
- @g.input(opts)
457
- " #{checkbox_text}" if show_value === true
458
- end
459
- end
460
- end
461
- end
462
- end
463
- alias checkbox input_checkbox
464
-
465
- ##
466
- # Generate an input tag with a type of "radio".
467
- #
468
- # If you want to generate multiple radio buttons you can use an array
469
- # just like you can with checkboxes. Example:
470
- #
471
- # @data = Class.new
472
- # attr_reader :gender_arr
473
- # attr_reader :gender_hash
474
- #
475
- # def initialize
476
- # @gender_arr = ['male', 'female']
477
- # @gender_hash = {"Male" => "male", "Female" => "female"}
478
- # end
479
- # end.new
480
- #
481
- # form_for(@data, :method => :post) do |f|
482
- # f.input_radio "Gender", :gender_arr
483
- # f.input_radio "Gender", :gender_hash
484
- # end
485
- #
486
- # For more information see the input_checkbox() method.
487
- #
488
- # @param [String] label The text to display inside the label tag.
489
- # @param [String Symbol] name The name of the radio button.
490
- # @param [String] checked String that indicates if (and which) radio
491
- # button should be checked.
492
- # @param [Hash] args Any additional HTML attributes along with their
493
- # values.
494
- # @see input_checkbox()
495
- # @example
496
- # form_for(@data, :method => :post) do |f|
497
- # f.input_radio 'Gender', :gender
498
- # end
499
- #
500
- def input_radio(label, name, checked = nil, args = {})
501
- # Force a type of "radio"
502
- args[:type] = :radio
503
-
504
- if !args[:span_class]
505
- args[:span_class] = "radio_wrap"
506
- end
507
-
508
- self.input_checkbox(label, name, checked, args)
509
- end
510
- alias radio input_radio
511
-
512
- ##
513
- # Generate a field for uploading files.
514
- #
515
- # @param [String] label The text to display inside the label tag.
516
- # @param [String Symbol] name The name of the radio tag.
517
- # @param [Hash] args Any additional HTML attributes along with their
518
- # values.
519
- # @example
520
- #
521
- # form_for(@data, :method => :post) do |f|
522
- # f.input_file 'Image', :image
523
- # end
524
- #
525
- def input_file(label, name, args = {})
526
- id = args[:id] ? args[:id] : id_for(name)
527
- args = args.merge(:type => :file, :name => name, :id => id)
528
-
529
- @g.p do
530
- label_for(id, label, name)
531
- @g.input(args)
532
- end
533
- end
534
- alias file input_file
535
-
536
- ##
537
- # Generate a hidden field. Hidden fields are essentially the same as
538
- # text fields except that they aren't displayed in the browser.
539
- #
540
- # @param [String Symbol] name The name of the hidden field tag.
541
- # @param [String] value The value of the hidden field
542
- # @param [Hash] args Any additional HTML attributes along with their
543
- # values.
544
- # @example
545
- #
546
- # form_for(@data, :method => :post) do |f|
547
- # f.input_hidden :user_id
548
- # end
549
- #
550
- def input_hidden(name, value = nil, args = {})
551
- args = args.merge(:type => :hidden, :name => name)
552
-
553
- if !value and @form_values.respond_to?(name)
554
- args[:value] = @form_values.send(name)
555
- else
556
- args[:value] = value
557
- end
558
-
559
- @g.input(args)
560
- end
561
- alias hidden input_hidden
562
-
563
- ##
564
- # Generate a text area.
565
- #
566
- # @param [String] label The text to display inside the label tag.
567
- # @param [String Symbol] name The name of the textarea.
568
- # @param [Hash] args Any additional HTML attributes along with their
569
- # values.
570
- # @example
571
- #
572
- # form_for(@data, :method => :post) do |f|
573
- # f.textarea 'Description', :description
574
- # end
575
- #
576
- def textarea(label, name, args = {})
577
- id = args[:id] ? args[:id] : id_for(name)
578
-
579
- # Get the value of the textarea
580
- if !args[:value] and @form_values.respond_to?(name)
581
- value = @form_values.send(name)
582
- else
583
- value = args[:value]
584
- args.delete(:value)
585
- end
586
-
587
- args = args.merge(:name => name, :id => id)
588
-
589
- @g.p do
590
- label_for(id, label, name)
591
- @g.textarea(args){ value }
592
- end
593
- end
594
-
595
- ##
596
- # Generate a select tag along with the option tags and a label.
597
- #
598
- # @param [String] label The text to display inside the label tag.
599
- # @param [String Symbol] name The name of the select tag.
600
- # @param [Hash] args Hash containing additional HTML attributes.
601
- # @example
602
- #
603
- # form_for(@data, :method => :post) do |f|
604
- # f.select 'Country', :country_list
605
- # end
606
- #
607
- def select(label, name, args = {})
608
- id = args[:id] ? args[:id] : id_for(name)
609
- multiple, size = args.values_at(:multiple, :size)
610
-
611
- # Get all the values
612
- if !args[:values] and @form_values.respond_to?(name)
613
- values = @form_values.send(name)
614
- else
615
- values = args[:values]
616
- args.delete(:values)
617
- end
618
-
619
- args[:multiple] = 'multiple' if multiple
620
- args[:size] = (size || values.count || 1).to_i
621
- args[:name] = multiple ? "#{name}[]" : name
622
- args = args.merge(:id => id)
623
-
624
- # Retrieve the selected value
625
- has_selected, selected = args.key?(:selected), args[:selected]
626
- selected = [selected] if !selected.is_a?(Array)
627
- args.delete(:selected)
628
-
629
- @g.p do
630
- label_for(id, label, name)
631
- @g.select args do
632
- values.each do |value, o_name|
633
- o_name ||= value
634
- o_args = {:value => value}
635
-
636
- if has_selected and selected.include?(value)
637
- o_args[:selected] = 'selected'
638
- end
639
-
640
- @g.option(o_args){ o_name }
641
- end
642
- end
643
- end
644
- end
645
-
646
- ##
647
- # Method used for converting the results of the BlueForm helper to a
648
- # string
649
- #
650
- # @return [String] The form output
651
- #
652
- def to_s
653
- @g.to_s
654
- end
655
-
656
- private
657
-
658
- ##
659
- # Generate a label based on the id and value.
660
- #
661
- # @param [String] id The ID to which the label belongs.
662
- # @param [String] value The text to display inside the label tag.
663
- # @param [String] name The name of the field to which the label belongs.
664
- #
665
- def label_for(id, value, name)
666
- if error = @form_errors.delete(name.to_s)
667
- @g.label("#{value} ", :for => id){ @g.span(:class => :error){ error } }
668
- else
669
- @g.label(value, :for => id)
670
- end
671
- end
672
-
673
- ##
674
- # Generate a value for an ID tag based on the field's name.
675
- #
676
- # @param [String] field_name The name of the field.
677
- # @return [String] The ID for the specified field name.
678
- #
679
- def id_for(field_name)
680
- if name = @form_args[:name]
681
- "#{name}_#{field_name}".downcase.gsub(/-/, '_')
682
- else
683
- "form_#{field_name}".downcase.gsub(/-/, '_')
684
- end
685
- end
686
- end # Form
687
- end # BlueForm
688
- end # Helper
689
- end # Ramaze