Loading README.txt +61 −21 Changes for README.txt: 61 added lines, 21 removed lines. Original line number Diff line number Diff line SECURITY WARNING ---------------- This filter is powerful, therefore it should be granted to trusted users only. If you allow this filter to untrusted users, then you have to make sure that EVERY VIEW EVERY DISPLAY (default display also!) has correct views access settings. CONTENTS OF THIS FILE --------------------- * Introduction * Security Warning * Requirements * Installation * Configuration * Performance * How to find a display id * Maintainers INTRODUCTION ------------ OVERVIEW -------- Insert view filter allows to embed views using tags. The tag syntax is relatively simple: [view:name=display=args]. The parameters are: view name, view display id, view arguments. For example [view:tracker=page=1] says, embed a view Loading @@ -21,30 +28,63 @@ Valid examples: [view:my_view=my_display=arg1/arg2/arg3] [view:my_view==arg1/arg2/arg3] HOW TO FIND A DISPLAY ID ------------------------ On the edit page for the view in question, you'll find a list of displays at the left side of the control area. "Defaults" will be at the top of that list. Hover your mouse pointer over the name of the display you want to use. A URL will appear in the status bar of your browser. This is usually at the bottom of the window, in the chrome. Everything after #views-tab- is the display ID. For example in admin/build/views/edit/tracker?destination=node%2F51#views-tab-page the display ID would be "page". SECURITY WARNING ---------------- This filter is powerful, therefore it should be granted to trusted users only. If you allow this filter to untrusted users, then you have to make sure that EVERY VIEW EVERY DISPLAY (default display also!) has correct views access settings. REQUIREMENTS ------------ No special requirements INSTALLATION ------------ Extract and save the insert_view folder in your site's modules folder and enable it at admin/build/modules. Obviously, it requires the Views module to do its magic. Once Insert view is installed, visit the the input formats page at Install as you would normally install a contributed Drupal module. See: https://drupal.org/documentation/install/modules-themes/modules-8 for further information. CONFIGURATION ------------- * Once Insert view is installed, visit the the input formats page at /admin/settings/filters and click the "configure" link for the input format(s) for which you wish to enable the Insert view filter. Then simply check the checkbox for the filter. PERFORMANCE ----------- To display views correctly, Insert view turns off caching for the input formats for which it is enabled. That means every node using this input format will not be cacheable. This can impact site performance. In these cases, it is recommended to create a special input format for use when inserting views. HOW TO FIND A DISPLAY ID ------------------------ On the edit page for the view in question, you'll find a list of displays at the left side of the control area. "Defaults" will be at the top of that list. Hover your mouse pointer over the name of the display you want to use. A URL will appear in the status bar of your browser. This is usually at the bottom of the window, in the chrome. Everything after #views-tab- is the display ID. For example in admin/build/views/edit/tracker?destination=node%2F51#views-tab-page the display ID would be "page". MAINTAINERS ----------- Current maintainers: * andrew morton (drewish) - https://www.drupal.org/user/34869 * Renato Gonçalves (RenatoG) - https://www.drupal.org/user/3326031 * Adam Balsam (balsama) - https://www.drupal.org/user/223087 * Michael Samuelson (mlsamuelson) - https://www.drupal.org/user/47411 * Adam Balsam (balsama) - https://www.drupal.org/user/223087 Loading
README.txt +61 −21 Changes for README.txt: 61 added lines, 21 removed lines. Original line number Diff line number Diff line SECURITY WARNING ---------------- This filter is powerful, therefore it should be granted to trusted users only. If you allow this filter to untrusted users, then you have to make sure that EVERY VIEW EVERY DISPLAY (default display also!) has correct views access settings. CONTENTS OF THIS FILE --------------------- * Introduction * Security Warning * Requirements * Installation * Configuration * Performance * How to find a display id * Maintainers INTRODUCTION ------------ OVERVIEW -------- Insert view filter allows to embed views using tags. The tag syntax is relatively simple: [view:name=display=args]. The parameters are: view name, view display id, view arguments. For example [view:tracker=page=1] says, embed a view Loading @@ -21,30 +28,63 @@ Valid examples: [view:my_view=my_display=arg1/arg2/arg3] [view:my_view==arg1/arg2/arg3] HOW TO FIND A DISPLAY ID ------------------------ On the edit page for the view in question, you'll find a list of displays at the left side of the control area. "Defaults" will be at the top of that list. Hover your mouse pointer over the name of the display you want to use. A URL will appear in the status bar of your browser. This is usually at the bottom of the window, in the chrome. Everything after #views-tab- is the display ID. For example in admin/build/views/edit/tracker?destination=node%2F51#views-tab-page the display ID would be "page". SECURITY WARNING ---------------- This filter is powerful, therefore it should be granted to trusted users only. If you allow this filter to untrusted users, then you have to make sure that EVERY VIEW EVERY DISPLAY (default display also!) has correct views access settings. REQUIREMENTS ------------ No special requirements INSTALLATION ------------ Extract and save the insert_view folder in your site's modules folder and enable it at admin/build/modules. Obviously, it requires the Views module to do its magic. Once Insert view is installed, visit the the input formats page at Install as you would normally install a contributed Drupal module. See: https://drupal.org/documentation/install/modules-themes/modules-8 for further information. CONFIGURATION ------------- * Once Insert view is installed, visit the the input formats page at /admin/settings/filters and click the "configure" link for the input format(s) for which you wish to enable the Insert view filter. Then simply check the checkbox for the filter. PERFORMANCE ----------- To display views correctly, Insert view turns off caching for the input formats for which it is enabled. That means every node using this input format will not be cacheable. This can impact site performance. In these cases, it is recommended to create a special input format for use when inserting views. HOW TO FIND A DISPLAY ID ------------------------ On the edit page for the view in question, you'll find a list of displays at the left side of the control area. "Defaults" will be at the top of that list. Hover your mouse pointer over the name of the display you want to use. A URL will appear in the status bar of your browser. This is usually at the bottom of the window, in the chrome. Everything after #views-tab- is the display ID. For example in admin/build/views/edit/tracker?destination=node%2F51#views-tab-page the display ID would be "page". MAINTAINERS ----------- Current maintainers: * andrew morton (drewish) - https://www.drupal.org/user/34869 * Renato Gonçalves (RenatoG) - https://www.drupal.org/user/3326031 * Adam Balsam (balsama) - https://www.drupal.org/user/223087 * Michael Samuelson (mlsamuelson) - https://www.drupal.org/user/47411 * Adam Balsam (balsama) - https://www.drupal.org/user/223087