Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Cutelyst4Qt6LangSelect(5)      File Formats Manual     Cutelyst4Qt6LangSelect(5)

NAME
     Cutelyst4Qt6LangSelect  -	Configuration  of  the LangSelect Plugin for the
     Cutelyst Web Framework

DESCRIPTION
     The LangSelect plugin can set the locale based on different definable input
     parameters like cookie or session values, URL query parameters and parts of
     the path or the domain. It will check if the language requested by the user
     agent is supported by the application. If the language is not supported, it
     will use a fallback language. As another fallback it will try  to	get  the
     locale from the @a Accept-Language header.

CONFIGURATION
     There  are  some options you can set in your application configuration file
     in the Cutelyst_LangSelect_Plugin section.

     cookie_expiration (integer or string value, default: 1 month)
	 The expiration time of the cookie. Can be given as time span where  the
	 following time units are understood:

	 *   usec, us

	 *   msec, ms

	 *   seconds, second, sec, s

	 *   minutes, minute, min, m

	 *   hours, hour, hr, h

	 *   days, day, d

	 *   weeks, week, w

	 *   months, month, M (defined as 30.44 days)

	 *   years, year, y (defined as 365.25 days)

	 If  no  time unit is specified, generally seconds are assumed. Examples
	 for valid time span specifications:

	     2 h
	     2hours
	     48hr
	     1y 12month
	     55s500ms
	     300ms20s 5day

     cookie_domain (string value, default: empty)
	 The domain to be used when setting the cookie. When empty, the  browser
	 will set the current domain.

     cookie_secure (boolean value, default: false)
	 Whether to use a secure cookie. If this is set to true, the cookie will
	 be marked as secure, which means browsers may ensure that the cookie is
	 only sent with an HTTPS connection.

     cookie_same_site (string value, default: lax)
	 Defines  the  SameSite attribute of the cookie. Read the MDN article to
	 learn more about SameSite cookies. Acceptable values are:

	 *   default - SameSite is not set. Can be interpreted as None or Lax by
	     the browser.

	 *   none - Cookies can be sent in all contexts. This  used  to  be  de-
	     fault,  but  recent browsers made Lax default, and will now require
	     the cookie to be both secure and to set SameSite=None.

	 *   lax - Cookies are sent on first party  requests  and  GET	requests
	     initiated	by  third  party  website. This is the default in modern
	     browsers (since mid 2020).

	 *   strict - Cookies will only be sent in a first-party context.

EXAMPLES
     [Cutelyst_LangSelect_Plugin]
     cookie_secure=true

LOGGING CATEGORY
     cutelyst.plugin.langselect

Cutelyst4Qt6LangSelect 4.7.0	   2023-11-09	       Cutelyst4Qt6LangSelect(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Cutelyst4Qt6LangSelect&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help