This Django app displays and tracks site navigation. It simplifies the process of navigating through a website and keeps track of user activity.
A significant advantage of the plugin is that the location structure does not need to follow the same hierarchy as the urls.py. This feature enables users to easily integrate off-site URLs and track them. Zamtools-navigation also allows specific locations to be hidden, which helps to maintain the site's structure without affecting the current location.
Benefits of using the plugin include explicit declaration of base and target URLs for off-site locations, hierarchy representation with easy navigation methods, and the ability to track both top and current locations using variables supplied by the context processors. Additionally, the plugin allows users to sort the location order to their preference by the order in which they were added.
The installation process is simple and can be done using "easy_install zamtools-navigation". To use the plugin, one must add Zamtools-navigation to the INSTALLED_APPS in the settings.py file and run "python manage.py syncdb" to synchronize the database.
Once installed, users can log in to the admin panel and create locations. It is recommended to surround base and target URLs with slashes to avoid any ambiguity in similar-looking URLs. By default, locations with no parents are considered "top level" locations, and locations can be hidden to maintain the site structure without affecting the current location.
The zamtools-navigation context processor adds "top_locations" and "current_location" variables to the context. "Top_locations" is a list of all locations without parents that are not hidden, while "current_location" is the location that most closely matches the current URL. This feature allows users to generate a menu with highlighting on the current location.
Overall, Zamtools-navigation is a great plugin for users who need to create hierarchical site maps and track their current location easily. The plugin also includes tests to verify that everything is working correctly, adding to the plugin's reliability.
Version 1.0: N/A