Merge pull request #1211 from TOMToolkit/1048-add-documentation-and-clarity-about-how-to-add-templatetags-with-a-custom_app

add customization clarification and links to tom_demoapp

Author: jchate6

docs/_static/customize_template_tags_doc/Templatetags.png

@@ -4,9 +4,9 @@ Customizing Template Tags
 The TOM Toolkit is designed to be as customizable as possible. A number
 of UI objects are rendered as Django templatetags. Django has quite a
 few `built-in template
-tags <https://docs.djangoproject.com/en/3.0/ref/templates/builtins/>`__,
+tags <https://docs.djangoproject.com/en/stable/ref/templates/builtins/>`__,
 but also allows the creation of `custom template
-tags <https://docs.djangoproject.com/en/3.0/howto/custom-template-tags/>`__,
+tags <https://docs.djangoproject.com/en/stable/howto/custom-template-tags/>`__,
 which the TOM Toolkit leverages heavily.
 
 However, it’s possible that a TOM Toolkit template tag doesn’t quite
@@ -15,6 +15,15 @@ quite what you’re looking for, or the target data isn’t formatted the
 way you’d like. This tutorial will show you how to write your own
 template tag to suit your own program better.
 
+Basics of Django Templating Vocabulary
+--------------------------------------
+Sometimes the different terms involved in Django Templating that we use here can be confusing.
+If you find yourself needing a reminder of what the different terms mean, we've included this graphic, for a more
+detailed description please see the
+`Django Template Documentation <https://docs.djangoproject.com/en/stable/topics/templates/>`__.
+
+|image0|
+
 Preparing your project for custom template tags
 -----------------------------------------------
 
@@ -320,3 +329,5 @@ easily modified.
 As far as this template tag goes, as of this tutorial, it’s now a part
 of the base TOM Toolkit, but all of the information here should provide
 you with the ability to write your own.
+
+.. |image0| image:: /_static/customize_template_tags_doc/Templatetags.png

docs/customization/customize_template_tags.rst

@@ -228,6 +228,23 @@ display the image:
 After reloading the page, you should now see ``mytom.jpg`` displayed
 instead of the remote cat image.
 
+Using Integration Points:
+=========================
+
+The TOM toolkit provides a number of "integration points" that allow you to integrate your code with the base TOM
+Toolkit code so you don't have to overwrite templates. This has several benefits, including flexibility what apps you
+include, automatic app compatibility, simpler app installation, and the ability to gain new TOM Base improvements
+without updating your existing code.
+
+The key to accessing these integration points is adding the integration methods to your AppConfig in your
+`custom_code.apps.py`file.
+
+Current integration points include adding items to the navigation bar, adding tom_specific profile information to the
+user profile page, and more. A complete `list of integrations <https://github.com/TOMToolkit/tom_demoapp/wiki>`__,
+`example code <https://github.com/TOMToolkit/tom_demoapp/blob/dev/tom_demoapp/apps.py>`__, and
+`descriptions <https://github.com/TOMToolkit/tom_demoapp/wiki/Integration-Points#example-integration-points>`__ are
+available in the `tom_demoapp <https://github.com/TOMToolkit/tom_demoapp>`__ repository.
+
 Further Reading
 ~~~~~~~~~~~~~~~