diff --git a/doc/guides/case_insensitive_login.rdoc b/doc/guides/case_insensitive_login.rdoc new file mode 100644 index 00000000..ccfa6771 --- /dev/null +++ b/doc/guides/case_insensitive_login.rdoc @@ -0,0 +1,13 @@ += Case insensitive logins + +If your database schema doesn't support case insensitive logins, you can tell +Rodauth to automatically lowercase login param values during authentication and +persistence via the +normalize_login+ configuration option: + + normalize_login(&:downcase) + +Of the four database types Rodauth officially supports (PostgreSQL, MySQL, +Microsoft SQL Server, and SQLite), only SQLite does not support a case +insensitive column for storing logins by default. However, other databases could +be configured to not use a case insensitive column for logins by default, in +which case you would want to use this setting. diff --git a/www/pages/documentation.erb b/www/pages/documentation.erb index c73f45ae..bf166db5 100644 --- a/www/pages/documentation.erb +++ b/www/pages/documentation.erb @@ -69,6 +69,7 @@