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 re-
       quested by the user agent is supported by the application. If the  lan-
       guage  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. Exam-
	   ples	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
	   <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-
	   Cookie#samesitesamesite-value> to learn more	about  SameSite	 cook-
	   ies.	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  re-
	       quire 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.5.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+14.3.quarterly>

home | help