mirror of
				https://github.com/encode/django-rest-framework.git
				synced 2025-10-31 07:57:55 +03:00 
			
		
		
		
	Document setting URL_FORMAT_OVERRIDE to None
This also hides the format dropdown from the Browsable API if URL_FORMAT_OVERRIDE is disabled. Closes #3057
This commit is contained in:
		
							parent
							
								
									1e678791de
								
							
						
					
					
						commit
						83ef64dbf5
					
				|  | @ -273,6 +273,8 @@ Default: `'accept'` | |||
| 
 | ||||
| The name of a URL parameter that may be used to override the default `Accept` header based content negotiation. | ||||
| 
 | ||||
| If the value of this setting is `None` then URL format overloading will be disabled. | ||||
| 
 | ||||
| Default: `'format'` | ||||
| 
 | ||||
| --- | ||||
|  |  | |||
|  | @ -72,20 +72,24 @@ | |||
|         {% if 'GET' in allowed_methods %} | ||||
|           <form id="get-form" class="pull-right"> | ||||
|             <fieldset> | ||||
|               <div class="btn-group format-selection"> | ||||
|                 <a class="btn btn-primary js-tooltip" href='{{ request.get_full_path }}' rel="nofollow" title="Make a GET request on the {{ name }} resource">GET</a> | ||||
|               {% if api_settings.URL_FORMAT_OVERRIDE %} | ||||
|                 <div class="btn-group format-selection"> | ||||
|                   <a class="btn btn-primary js-tooltip" href="{{ request.get_full_path }}" rel="nofollow" title="Make a GET request on the {{ name }} resource">GET</a> | ||||
| 
 | ||||
|                 <button class="btn btn-primary dropdown-toggle js-tooltip" data-toggle="dropdown" title="Specify a format for the GET request"> | ||||
|                   <span class="caret"></span> | ||||
|                 </button> | ||||
|                 <ul class="dropdown-menu"> | ||||
|                   {% for format in available_formats %} | ||||
|                     <li> | ||||
|                       <a class="js-tooltip format-option" href='{% add_query_param request api_settings.URL_FORMAT_OVERRIDE format %}' rel="nofollow" title="Make a GET request on the {{ name }} resource with the format set to `{{ format }}`">{{ format }}</a> | ||||
|                     </li> | ||||
|                   {% endfor %} | ||||
|                 </ul> | ||||
|               </div> | ||||
|                   <button class="btn btn-primary dropdown-toggle js-tooltip" data-toggle="dropdown" title="Specify a format for the GET request"> | ||||
|                     <span class="caret"></span> | ||||
|                   </button> | ||||
|                   <ul class="dropdown-menu"> | ||||
|                     {% for format in available_formats %} | ||||
|                       <li> | ||||
|                         <a class="js-tooltip format-option" href="{% add_query_param request api_settings.URL_FORMAT_OVERRIDE format %}" rel="nofollow" title="Make a GET request on the {{ name }} resource with the format set to `{{ format }}`">{{ format }}</a> | ||||
|                       </li> | ||||
|                     {% endfor %} | ||||
|                   </ul> | ||||
|                 </div> | ||||
|               {% else %} | ||||
|                 <a class="btn btn-primary js-tooltip" href="{{ request.get_full_path }}" rel="nofollow" title="Make a GET request on the {{ name }} resource">GET</a> | ||||
|               {% endif %} | ||||
|             </fieldset> | ||||
|           </form> | ||||
|         {% endif %} | ||||
|  |  | |||
		Loading…
	
		Reference in New Issue
	
	Block a user