Skip to content

Commit f517bef

Browse files
committed
Update tests and readme after partial migration; address #1028.
1 parent 3b7b61f commit f517bef

2 files changed

Lines changed: 49 additions & 12 deletions

File tree

README.md

Lines changed: 28 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,16 @@ This is the CMS for the University of Alberta Libraries website. It uses Comfy M
99
## Development environment
1010

1111
+ Ruby < 3.5
12-
+ Rails 7.0.x
12+
+ Rails 8.1.x
1313
+ MariaDB 5.5
1414
+ Docker and docker-compose
15-
+ yarn
15+
+ yarn
1616
+ nodejs v18+
1717

1818
## Requirements
1919

20+
Update: As of August 2026, ActiveStorage is not being used (images are located outside the CMS).
21+
2022
File attachments are handled by ActiveStorage. You will need to copy over database migrations by running rails active_storage:install
2123
To resize attached images you'll need to have ImageMagic installed.
2224
Pagination is handled by either Kaminari or WillPaginate. Make sure you have one defined in your Gemfile.
@@ -40,8 +42,30 @@ bundle exec rails test
4042

4143
This will execute all the test cases and provide you with the test results.
4244

43-
NOTE: We preload the test database with all the seed CMS data (pages/layouts/etc) before tests are ran. This happens only once.
44-
So if you make a change to the CMS seed data, you must drop the test DB for your changes to be reflected in the test database.
45+
NOTE: We preload the test database with all the seed CMS data (pages/layouts/etc) before tests are run. This happens only once.
46+
Therefore, if you make a change to the CMS seed data, you must drop the test DB for your changes to be reflected in the test database.
47+
48+
### Manual testing
49+
50+
As part of the August 2026 partial migration of content from this CMS tool to the centrally managed CMS, most of the routes available in the CMS (and seed data) are redirected by production server to the central CMS. See [CR1345](https://monitor.library.ualberta.ca/unixDoc/Change/2026/Q3/CR1345.html) for details.
51+
52+
Manual testing should focus on the routes that are not being redirected (i.e., retained in the Library CMS) which include:
53+
54+
+ /admin (admin route)
55+
+ /archives
56+
+ /peel
57+
+ /staffhub
58+
+ /cms-css/1/archives.css
59+
+ /cms-css/1/english-main.css
60+
+ /cms-css/1/peel-prairie-provinces.css
61+
+ /cms-css/1/left-navigation-html.css
62+
+ /assets/ (Rails generated assets used mainly by the admin route)
63+
64+
The above is not an exhaustive list.
65+
66+
These routes should be manually tested when building releases of Library CMS.
67+
68+
The CMS seed data stored in this repository is not regularly updated from production.
4569

4670
## Features
4771

test/integration/cms_test.rb

Lines changed: 21 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,19 +9,32 @@ class CmsTest < ActionDispatch::IntegrationTest
99
assert_response :success
1010
assert_select "h2", "Search the Library"
1111
end
12-
test "ask us page" do
13-
get comfy_cms_render_page_path(cms_path: "ask-us")
12+
13+
test "archives" do
14+
get comfy_cms_render_page_path(cms_path: "archives")
15+
16+
assert_response :success
17+
assert_select "h2", "University of Alberta Archives"
18+
end
19+
20+
test "Peel" do
21+
get comfy_cms_render_page_path(cms_path: "peel")
22+
23+
assert_response :success
24+
assert_select "h1", "Peel's Prairie Provinces"
25+
assert_select "h2", "Peel's Prairie Provinces"
26+
end
27+
28+
test "comfy admin CSS loads" do
29+
get "/assets/comfy/admin/cms/application.css"
1430

1531
assert_response :success
16-
assert_select "h1", /Ask Us/
17-
assert_select "h2", "Chat with Us"
32+
assert_includes response.body, "comfy"
1833
end
1934

20-
test "about page" do
21-
get comfy_cms_render_page_path(cms_path: "about")
35+
test "layout CSS english-main loads" do
36+
get "/cms-css/1/english-main.css"
2237

2338
assert_response :success
24-
assert_select "h1", /About the Library/
25-
assert_select "h2", "A Message from our Chief Librarian"
2639
end
2740
end

0 commit comments

Comments
 (0)