Server restart needed to load new tags and filters

[Katya <internum.odium@…>]

​https://docs.djangoproject.com/en/1.5/howto/custom-template-tags/

It would be nice to mention that to have new tags and filters loaded one should restart the server.

[Baptiste Mispelon]

Hi,

I agree, this would be a welcome addition.

[Daniele Procida]

I have tentatively reserved this ticket for first-time committers who take part in the ​Don't be afraid to commit workshop at the ​DjangoCon Europe 2013 sprints on 18th and 19th May.

If you want to tackle this ticket before then, please don't let the fact that it's assigned to me stop you. Feel free to re-assign it to yourself and do whatever you like to it.

[DjangoPanngo]

Suggested addition to the documentation.

[DjangoPanngo]

Please review and advise if the layout/content/placement need to change.

[Krzysztof Malinowski <boromil@…>]

Sorry about taking this ticket off you DjangoPanngo - I've tried before to sign it to myself but it only showed anonymous... anyway I also submitted a proposition through ​githubs pull request. Your look good to so let someone else decide.

[DjangoPanngo]

Moving this back to accepted because it's missing mentioning of filters.

[boromil]

​This is the updated branch with the corrected info.

[Tim Graham]

I'm not sure exactly what requires reloading the server? I was testing with the staticfiles template tag and got an error "TemplateSyntaxError: Invalid block tag: 'static'". I then added "{% load staticfiles %}" to the template and didn't reload the development server, but the error was resolved when refreshing the page.

[Zbigniew Siciarz]

It's not about adding new {% load %} tags to the template. The reload is necessary when you add new Python module containing tags or filters definitions to the templatetags subdirectory of an app.

[Tim Graham]

Tried that as well. Added {% load foo %} to a template without that module in myapp.templatetags and got the error:

TemplateSyntaxError:
  'foo' is not a valid tag library: Template library foo not found,
  tried django.templatetags.foo,myapp.templatetags.foo,etc.

Then added foo.py to myapp.templatetags and refreshed the page without reloading the server and the filter in "foo" worked.

[Carl Meyer]

The problem occurs only when an app in INSTALLED_APPS does not have a templatetags submodule at all, and then one is added while the server is running; Django won't see it unless you restart the server.

[Tim Graham <timograham@…>]

In a46a399534c26abd3f4984149b820f34869d6b74:

Fixed #20417 - Noted that a server restart is required to load new templatetag modules.

Thanks Katya for the suggestion.

[Tim Graham <timograham@…>]

In 9ed2121eca0d4543dd665d7c5a3015beaee28eb4:

[1.5.x] Fixed #20417 - Noted that a server restart is required to load new templatetag modules.

Thanks Katya for the suggestion.

Backport of a46a399534 from master