Wikipedia:Lua/Modul/URLutil/en - Versionsgeschichte

PerfektesChaos: k

2024-11-06T13:40:33Z

← Nächstältere Version		Version vom 6. November 2024, 15:40 Uhr
Zeile 20:		Zeile 20:
	: Decoding of URL encoded string, but <code>[\|]</code> will be HTML-escaped		: Decoding of URL encoded string, but <code>[\|]</code> will be HTML-escaped
	: Parameter '''2''' – (optional) encoding		: Parameter '''2''' – (optional) encoding
	:* <code>2=%</code> – ~~QUERY,~~ spaces as plus		:* <code>2=QUERY</code> – spaces as plus
	:* <code>2=WIKI</code> – sparse encoding, spaces as underscore		:* <code>2=WIKI</code> – sparse encoding, spaces as underscore
	:* <code>2=PATH</code> – spaces percent-encoded		:* <code>2=PATH</code> – spaces percent-encoded
Zeile 27:		Zeile 27:
	: Critical characters at start wil be encoded as well as link brackets and pipe.		: Critical characters at start wil be encoded as well as link brackets and pipe.
	: Parameter '''2''' – (optional) encoding		: Parameter '''2''' – (optional) encoding
	:* <code>2=%</code> – ~~QUERY,~~ spaces as plus		:* <code>2=QUERY</code> – spaces as plus
	:* <code>2=WIKI</code> – sparse encoding, spaces as underscore		:* <code>2=WIKI</code> – sparse encoding, spaces as underscore
	:* <code>2=PATH</code> – spaces percent-encoded		:* <code>2=PATH</code> – spaces percent-encoded
Zeile 193:		Zeile 193:
	* URLutil.isWebURL()		* URLutil.isWebURL()
	* URLutil.wikiEscapeURL()		* URLutil.wikiEscapeURL()
	* URLutil.[[#failsafe\|failsafe]](atleast)		* URLutil.[[#failsafe\|failsafe]]( atleast )
	*:# atleast<br /> ''optional''<br /> ''nil'' or minimal version request or <code>"wikidata"</code>		*:# atleast<br /> ''optional''<br /> ''nil'' or minimal version request or <code>"wikidata"</code>
	*: Returns: ''string'' or ''false''
	If succeeding, the ''URLutil.get()'' return a string, the ''URLutil.is()'' <code>true</code> (if no exception mentioned); on failure always <code>false</code>.

	Furthermore there are three string constants:		Furthermore there are three string constants:

PerfektesChaos: update

2024-11-05T21:15:51Z

update

← Nächstältere Version		Version vom 5. November 2024, 23:15 Uhr
Zeile 14:		Zeile 14:
	The return value is an empty string (“nothing”), if the parameter value does not fulfil the expectations. If there is a result or the query condition is true, at least one visible character will be returned. The result does not begin or end with a space, and HTML entities will be decoded.		The return value is an empty string (“nothing”), if the parameter value does not fulfil the expectations. If there is a result or the query condition is true, at least one visible character will be returned. The result does not begin or end with a space, and HTML entities will be decoded.

			; anchorencode
			: Encoding to be appropriate for <code>id=""</code> HTML attributes.
			: Parameter '''2''' – (optional) allow leading digit
			; decode
			: Decoding of URL encoded string, but <code>[\|]</code> will be HTML-escaped
			: Parameter '''2''' – (optional) encoding
			:* <code>2=%</code> – QUERY, spaces as plus
			:* <code>2=WIKI</code> – sparse encoding, spaces as underscore
			:* <code>2=PATH</code> – spaces percent-encoded
	; encode		; encode
	: Encoding similar to parser function <code><nowiki>{{urlencode:}}</nowiki></code>		: Encoding similar to parser function <code><nowiki>{{urlencode:}}</nowiki></code>
Zeile 132:		Zeile 141:
	; failsafe		; failsafe
	: Version identification		: Version identification
	{{Wikipedia:Lua/Modul-Failsafe/en\|~~Modul~~=URLutil}}		{{Wikipedia:Lua/Modul-Failsafe/en\|Module=URLutil}}

	=== Examples (test page) ===		=== Examples (test page) ===
Zeile 140:		Zeile 149:

	All functions described above can be used by other modules:		All functions described above can be used by other modules:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua" copy="1">
	local lucky, URLutil = pcall( require, "Module:URLutil" )		local lucky, URLutil = pcall( require, "Module:URLutil" )
	if type( URLutil ) == "table" then		if type( URLutil ) == "table" then
	URLutil = ~~URLutil.~~URLutil()		URLutil = URLutil()
	else		else
	-- failure; URLutil is the error message		-- failure; URLutil is the error message
Zeile 150:		Zeile 159:
	</syntaxhighlight>		</syntaxhighlight>
	Subsequently there are available:		Subsequently there are available:
			* URLutil.anchorencode()
			* URLutil.decode()
	* URLutil.encode()		* URLutil.encode()
	* URLutil.getAuthority()		* URLutil.getAuthority()

PerfektesChaos: failsafe update

2022-04-04T14:31:38Z

failsafe update

← Nächstältere Version		Version vom 4. April 2022, 16:31 Uhr
Zeile 131:		Zeile 131:
	:* Otherwise <code>[ \| ]</code> replaced by webserver safe HTML entities. A pipe is not possible in plain template syntax.		:* Otherwise <code>[ \| ]</code> replaced by webserver safe HTML entities. A pipe is not possible in plain template syntax.
	; failsafe		; failsafe
	: Version identification ~~(local): <code>{{#invoke:URLutil\|failsafe}}</code>~~		: Version identification
			{{Wikipedia:Lua/Modul-Failsafe/en\|Modul=URLutil}}
	: Optional additional parameter <code>1</code> – requested minimal version identification<!-- , or keyword <code>wikidata</code> -->
	: ''Returns:''
	::* (empty), if minimal version condition not matched
	::* version ID (local or @wikidata: <code>{{#invoke:URLutil\|failsafe\|wikidata}}</code>)

	=== Examples (test page) ===		=== Examples (test page) ===

PerfektesChaos: + isHostPathResource

2019-03-25T15:17:17Z

+ isHostPathResource

← Nächstältere Version		Version vom 25. März 2019, 17:17 Uhr
Zeile 81:		Zeile 81:
	; isHost		; isHost
	: Is it a server address without port (also IP)?		: Is it a server address without port (also IP)?
			:* <code>1</code> – ''yes''
			; isHostPathResource
			: Is it a resource URL or a resource URL without protocol part?
	:* <code>1</code> – ''yes''		:* <code>1</code> – ''yes''
	; isIP		; isIP

PerfektesChaos: + encode()

2018-09-21T13:30:44Z

+ encode()

← Nächstältere Version		Version vom 21. September 2018, 15:30 Uhr
Zeile 14:		Zeile 14:
	The return value is an empty string (“nothing”), if the parameter value does not fulfil the expectations. If there is a result or the query condition is true, at least one visible character will be returned. The result does not begin or end with a space, and HTML entities will be decoded.		The return value is an empty string (“nothing”), if the parameter value does not fulfil the expectations. If there is a result or the query condition is true, at least one visible character will be returned. The result does not begin or end with a space, and HTML entities will be decoded.

			; encode
			: Encoding similar to parser function <code><nowiki>{{urlencode:}}</nowiki></code>
			: Critical characters at start wil be encoded as well as link brackets and pipe.
			: Parameter '''2''' – (optional) encoding
			:* <code>2=%</code> – QUERY, spaces as plus
			:* <code>2=WIKI</code> – sparse encoding, spaces as underscore
			:* <code>2=PATH</code> – spaces percent-encoded
	; getAuthority		; getAuthority
	: Extract server access from a resource URL (lowercase result)		: Extract server access from a resource URL (lowercase result)
Zeile 143:		Zeile 150:
	</syntaxhighlight>		</syntaxhighlight>
	Subsequently there are available:		Subsequently there are available:
			* URLutil.encode()
	* URLutil.getAuthority()		* URLutil.getAuthority()
	* URLutil.getFragment()		* URLutil.getFragment()

PerfektesChaos: +

2018-08-10T11:02:56Z

← Nächstältere Version		Version vom 10. August 2018, 13:02 Uhr
Zeile 124:		Zeile 124:
	: Optional additional parameter <code>1</code> – requested minimal version identification<!-- , or keyword <code>wikidata</code> -->		: Optional additional parameter <code>1</code> – requested minimal version identification<!-- , or keyword <code>wikidata</code> -->
	: ''Returns:''		: ''Returns:''
	:* (empty), if minimal version condition not matched		::* (empty), if minimal version condition not matched
	:* ~~local~~ version ~~otherwise<!--~~ , or ~~registered~~ ~~on Wikidata (~~<code>{{#invoke:URLutil\|failsafe\|wikidata}}</code>) ~~when <code>wikidata</code> -->~~		::* version ID (local or @wikidata: <code>{{#invoke:URLutil\|failsafe\|wikidata}}</code>)

	=== Examples (test page) ===		=== Examples (test page) ===
Zeile 174:		Zeile 174:
	* URLutil.isWebURL()		* URLutil.isWebURL()
	* URLutil.wikiEscapeURL()		* URLutil.wikiEscapeURL()
	* URLutil.failsafe()		* URLutil.[[#failsafe\|failsafe]](atleast)
			*:# atleast<br /> ''optional''<br /> ''nil'' or minimal version request or <code>"wikidata"</code>
			*: Returns: ''string'' or ''false''
	If succeeding, the ''URLutil.get()'' return a string, the ''URLutil.is()'' <code>true</code> (if no exception mentioned); on failure always <code>false</code>.		If succeeding, the ''URLutil.get()'' return a string, the ''URLutil.is()'' <code>true</code> (if no exception mentioned); on failure always <code>false</code>.

PerfektesChaos: updates

2018-01-28T16:02:40Z

updates

← Nächstältere Version		Version vom 28. Januar 2018, 18:02 Uhr
Zeile 10:		Zeile 10:
	== {{Anker\|template}} Functions for templates ==		== {{Anker\|template}} Functions for templates ==

	~~All~~ functions expect exactly one unnamed parameter (which should be provided to get a meaningful answer). Whitespace ahead and after content is ignored.		Most functions expect exactly one unnamed parameter (which should be provided to get a meaningful answer). Whitespace ahead and after content is ignored.

	The return value is an empty string (“nothing”), if the parameter value does not fulfil the expectations. If there is a result or the query condition is true, at least one visible character will be returned. The result does not begin or end with a space, and HTML entities will be decoded.		The return value is an empty string (“nothing”), if the parameter value does not fulfil the expectations. If there is a result or the query condition is true, at least one visible character will be returned. The result does not begin or end with a space, and HTML entities will be decoded.
Zeile 94:		Zeile 94:
	; isMailLink		; isMailLink
	: Is it an e-mail link (<nowiki>mailto:</nowiki>)?		: Is it an e-mail link (<nowiki>mailto:</nowiki>)?
	:* <code>1</code> – ''yes''
	; isProtocolMW
	: Is it an URL or scheme keyword, which is commonly recognized by the MediaWiki sofware?
	: Current list see [https://doc.wikimedia.org/mediawiki-core/master/php/html/DefaultSettings_8php_source.html#l03387]
	:* <code>1</code> – ''yes''		:* <code>1</code> – ''yes''
	; isProtocolDialog		; isProtocolDialog
Zeile 124:		Zeile 120:
	:* Identical with parameter, if no problematic character present.		:* Identical with parameter, if no problematic character present.
	:* Otherwise <code>[ \| ]</code> replaced by webserver safe HTML entities. A pipe is not possible in plain template syntax.		:* Otherwise <code>[ \| ]</code> replaced by webserver safe HTML entities. A pipe is not possible in plain template syntax.
			; failsafe
			: Version identification (local): <code>{{#invoke:URLutil\|failsafe}}</code>
			: Optional additional parameter <code>1</code> – requested minimal version identification<!-- , or keyword <code>wikidata</code> -->
			: ''Returns:''
			:* (empty), if minimal version condition not matched
			:* local version otherwise<!-- , or registered on Wikidata (<code>{{#invoke:URLutil\|failsafe\|wikidata}}</code>) when <code>wikidata</code> -->

	=== Examples (test page) ===		=== Examples (test page) ===
Zeile 165:		Zeile 167:
	* URLutil.isMailAddress()		* URLutil.isMailAddress()
	* URLutil.isMailLink()		* URLutil.isMailLink()
⚫	* URLutil.~~isProtocolWM~~()
	* URLutil.isProtocolDialog()		* URLutil.isProtocolDialog()
	* URLutil.isProtocolWiki()		* URLutil.isProtocolWiki()
Zeile 173:		Zeile 174:
	* URLutil.isWebURL()		* URLutil.isWebURL()
	* URLutil.wikiEscapeURL()		* URLutil.wikiEscapeURL()
		⚫	* URLutil.failsafe()
	If succeeding, the ''URLutil.get()'' return a string, the ''URLutil.is()'' <code>true</code> (if no exception mentioned); on failure always <code>false</code>.		If succeeding, the ''URLutil.get()'' return a string, the ''URLutil.is()'' <code>true</code> (if no exception mentioned); on failure always <code>false</code>.

	Furthermore there are ~~two~~ string constants:		Furthermore there are three string constants:
	* URLutil.serial – current version ID (date)		* URLutil.serial – ''string'', current version ID (date)
	* URLutil.suite – <code>"URLutil"</code>		* URLutil.suite – <code>"URLutil"</code>
			* URLutil.item – ''number'', Item on Wikidata

	== Usage ==		== Usage ==
Zeile 192:		Zeile 195:

	[[:en:Special:Permalink/542839577?title=Module:IPAddress\|en:Module:IPAddress]] – 2013-03-01		[[:en:Special:Permalink/542839577?title=Module:IPAddress\|en:Module:IPAddress]] – 2013-03-01
	* Unit tests: [[:en:Module:IPAddress/~~tests~~]]		* Unit tests: [[:en:Module:IPAddress/testcases]]

	[[Kategorie:Wikipedia:Lua/Modul/Dokumentation\|URLutil]]		[[Kategorie:Wikipedia:Lua/Modul/Dokumentation\|URLutil]]

PerfektesChaos: updates

2015-12-13T17:01:14Z

updates

← Nächstältere Version		Version vom 13. Dezember 2015, 19:01 Uhr
Zeile 141:		Zeile 141:
	</syntaxhighlight>		</syntaxhighlight>
	Subsequently there are available:		Subsequently there are available:
⚫	* URLutil.~~getURIScheme~~()
	* URLutil.getAuthority()		* URLutil.getAuthority()
	* URLutil.getFragment()		* URLutil.getFragment()
Zeile 149:		Zeile 148:
	* URLutil.getPort()<br />numerical value, or <code>false</code>		* URLutil.getPort()<br />numerical value, or <code>false</code>
	* URLutil.getQuery()		* URLutil.getQuery()
			* URLutil.getQueryTable(url, separator)<br />''table'' with all assignments ''key=value''
	* URLutil.getRelativePath()		* URLutil.getRelativePath()
	* URLutil.getScheme()		* URLutil.getScheme()
Zeile 157:		Zeile 157:
	* URLutil.isDomain()		* URLutil.isDomain()
	* URLutil.isDomainExample()		* URLutil.isDomainExample()
		⚫	* URLutil.isDomainInt()
	* URLutil.isHost()		* URLutil.isHost()
	* URLutil.isIP()<br />numerical 4, 6, or <code>false</code>		* URLutil.isIP()<br />numerical 4, 6, or <code>false</code>
Zeile 173:		Zeile 174:
	* URLutil.wikiEscapeURL()		* URLutil.wikiEscapeURL()
	If succeeding, the ''URLutil.get()'' return a string, the ''URLutil.is()'' <code>true</code> (if no exception mentioned); on failure always <code>false</code>.		If succeeding, the ''URLutil.get()'' return a string, the ''URLutil.is()'' <code>true</code> (if no exception mentioned); on failure always <code>false</code>.

			Furthermore there are two string constants:
			* URLutil.serial – current version ID (date)
			* URLutil.suite – <code>"URLutil"</code>

	== Usage ==		== Usage ==

PerfektesChaos: kl.erg

2014-12-25T17:58:53Z

kl.erg

← Nächstältere Version		Version vom 25. Dezember 2014, 19:58 Uhr
Zeile 31:		Zeile 31:
	: Extract resource URL without a fragment, if any		: Extract resource URL without a fragment, if any
	; getPath		; getPath
	: Extract path from a resource URL without any query or fragment		: Extract path from a resource URL without any query or fragment.
			: Beginning with <code>/</code> as basic resource identification.
	; getPort		; getPort
	: Extract port number from a resource URL (numeric result)		: Extract port number from a resource URL (numeric result)

PerfektesChaos: +

2014-11-04T19:53:42Z

← Nächstältere Version		Version vom 4. November 2014, 21:53 Uhr
Zeile 17:		Zeile 17:
	: Extract server access from a resource URL (lowercase result)		: Extract server access from a resource URL (lowercase result)
	:* ''nothing'' – if invalid		:* ''nothing'' – if invalid
			; getFragment
			: Extract fragment (if any) from a resource URL
			: Parameter '''2''' – (optional) decoding
			:* <code>2=%</code> – URL is %-coded
			:* <code>2=WIKI</code> – URL is Wiki-coded with dots and underscore
			: Result:
			:* ''nothing'' – if not present
			:* starting with <code>#</code> – if present
	; getHost		; getHost
	: Extract domain or IP address from a resource URL (lowercase result)		: Extract domain or IP address from a resource URL (lowercase result)
	:* ''nothing'' – if invalid		:* ''nothing'' – if invalid
			; getLocation
			: Extract resource URL without a fragment, if any
			; getPath
			: Extract path from a resource URL without any query or fragment
	; getPort		; getPort
	: Extract port number from a resource URL (numeric result)		: Extract port number from a resource URL (numeric result)
	:* ''nothing'' – if not present or invalid		:* ''nothing'' – if not present or invalid
			; getQuery
			: Extract query from a resource URL
			: Parameter '''2''' – (optional) single parameter name
			: Parameter '''3''' – alternative separator like <code>;</code> – default: <code>&</code>
			: Result:
			:* ''nothing'' – if not present<includeonly>
			:* starting with <code>?</code> – if present</includeonly>
			:* single value, if single parameter requested
			; getRelativePath
			: Extract path and query including fragment (if any) from a resource URL but relative to host.
	; getScheme {{Anker\|getScheme}}		; getScheme {{Anker\|getScheme}}
	: Extract scheme from a resource URL (lowercase result, including double slashes)		: Extract scheme from a resource URL (lowercase result, including double slashes)
Zeile 120:		Zeile 142:
	* URLutil.getURIScheme()		* URLutil.getURIScheme()
	* URLutil.getAuthority()		* URLutil.getAuthority()
			* URLutil.getFragment()
	* URLutil.getHost()		* URLutil.getHost()
			* URLutil.getLocation()
			* URLutil.getPath()
	* URLutil.getPort()<br />numerical value, or <code>false</code>		* URLutil.getPort()<br />numerical value, or <code>false</code>
			* URLutil.getQuery()
			* URLutil.getRelativePath()
	* URLutil.getScheme()		* URLutil.getScheme()
	* URLutil.getTLD()		* URLutil.getTLD()