mirror of
				https://github.com/asterisk/asterisk.git
				synced 2025-10-31 02:37:10 +00:00 
			
		
		
		
	app.c: Allow ampersands in playback lists to be escaped.
Any function or application that accepts a `&`-separated list of
filenames can now include a literal `&` in a filename by wrapping the
entire filename in single quotes, e.g.:
```
exten = _X.,n,Playback('https://example.com/sound.cgi?a=b&c=d'&hello-world)
```
Fixes #172
UpgradeNote: Ampersands in URLs passed to the `Playback()`,
`Background()`, `SpeechBackground()`, `Read()`, `Authenticate()`, or
`Queue()` applications as filename arguments can now be escaped by
single quoting the filename. Additionally, this is also possible when
using the `CONFBRIDGE` dialplan function, or configuring various
features in `confbridge.conf` and `queues.conf`.
			
			
This commit is contained in:
		| @@ -49,9 +49,15 @@ | ||||
| 				name.</para> | ||||
| 			</parameter> | ||||
| 			<parameter name="filenames" argsep="&"> | ||||
| 				<argument name="filename" required="true"> | ||||
| 					<para>file(s) to play before reading digits or tone with option i</para> | ||||
| 				</argument> | ||||
| 				<para>Ampersand separated list of filenames to play before | ||||
| 				reading digits or tone with option <literal>i</literal>. If | ||||
| 				the filename is a relative filename (it does not begin with a | ||||
| 				slash), it will be searched for in the Asterisk sounds | ||||
| 				directory. If the filename is able to be parsed as a URL, | ||||
| 				Asterisk will download the file and then begin playback on | ||||
| 				it. To include a literal <literal>&</literal> in the URL | ||||
| 				you can enclose	the URL in single quotes.</para> | ||||
| 				<argument name="filename" required="true" /> | ||||
| 				<argument name="filename2" multiple="true" /> | ||||
| 			</parameter> | ||||
| 			<parameter name="maxdigits"> | ||||
|   | ||||
		Reference in New Issue
	
	Block a user