docs(15.9): follow the removal of the JSP search UI and the JAR theme type - #559
Merged
Merged
Conversation
… type Fess 15.9 removed the JSP search screens and the fess-theme plugin type (codelibs/fess#3497). Saving the General settings no longer copies JSP files per virtual host, the login page is served from WEB-INF/view/admin/login/ for every virtual host, and a fess-theme-*.jar is only kept as a plain jar that changes nothing. Update the 15.9 pages in all seven languages that still described the old behavior: the virtual host note, the JAR theme section of the theme development guide (now a short "removed in 15.9, move to a static theme" section), the plugin type tables, the plugin API type list, the theme guide note, the webapp plugin guide's addDesignJspFileName advice, the busy.jsp error page of load control, and the password change flow of the role search page. The upgrade notes now say that per-virtual-host login pages and JAR themes are gone, and that custom fields shown in the JSP results must also be added to query.additional.api.response.fields.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Bring the 15.9 documentation in line with codelibs/fess#3497, which removed the JSP search UI and the
fess-theme(JAR theme) plugin type.In 15.9, saving the General settings no longer copies JSP files into
WEB-INF/view/<virtual host>/, the login page (/login/) is served fromWEB-INF/view/admin/login/for every virtual host, and afess-theme-*.jaris kept only as a plainjarthat changes nothing. Several pages still described the old behavior.Changes
All seven languages, 15.9 tree only (10 files per language):
config/security-virtual-host.rst: no JSP files are generated; the login page is shared by all virtual hosts; a virtual host's look comes from the static theme named after it.dev/theme-development.rst: the JAR theme plugin section is replaced by a short "removed in 15.9" section. It says what happens to such a jar (installed as a plain jar, removable from the plugin page or withfess-setup remove plugin), thatfess-setupno longer lists or installs them, and how to move to a static theme. The JAR theme examples are dropped from the list of existing themes.dev/plugin-architecture.rst:fess-theme-*is removed from the plugin type table and the published plugin list, with a note pointing to static themes.api/admin/api-admin-plugin.rst: thetypevalues no longer includefess-theme, and now listfess-storageandfess-sso(the ids inPluginHelper.ArtifactType).admin/theme-guide.rst: the JAR theme note says the type was removed.dev/webapp-plugin.rst: the replacement warning no longer tells readers to copyaddDesignJspFileNamecalls (the method is gone, and a replacement that still calls it fails withBeanMethodNotFoundException); the search-screen section points only to static themes.config/load-control.rst: a web request over the limit gets the theme's error page, notbusy.jsp.dev/overview.rst:WEB-INF/view/now holds the admin and login JSPs only.user/role-search.rst: after a password change the user is logged out and logs in again; the page is the theme's/profile, which callsPOST /api/v2/auth/password.install/upgrade.rst(15.8 to 15.9, static theme section): per-virtual-host login pages and JAR theme plugins are gone. Custom fields shown in the JSP results must also be added toquery.additional.api.response.fields, since the static theme reads results from/api/v2/searchand that API returns only the fields on its allow-list.Checks
python3 tools/check_headings.pyon every changed file: no mismatches