How to use "Find Includes"
You can search for all the locations where a specific MultiExcerpt has been included by using the Find Includes feature
- Navigate to the page where the MultiExcerpt is located
- Click (page edit mode) to view the MultiExcerpt macro
- Click on the MultiExcerpt macro and a few options will display
- Click on 'Find Includes'
- The list of pages that include that MultiExcerpt are listed. Clicking on the link will take you to that page.
If "Find Includes" is very CPU-intensive or slow on your server then your site is probably large enough that the DB query that it is using is reaching its limits.
- The admin can disable the "Find Include" button for their site
- If a user attempts the use the "find includes" feature and it has been disabled they will see this message
If "Find Includes" returns no pages and you know that the MultiExcerpt is included on at least one page:
- CASE SENSITIVITY:
- "Find includes" is case-sensitive but MultiExcerpt Include is not: CMEP-87
- If your MultiExcerpt Include uses an excerpt by including it using a name that has different case than the excerpt it will include the excerpt (eg. 'MyExcerpt' vs 'myexcerpt')
- The "Find Includes" button will NOT find any MultiExcerpt Includes that include an excerpt using the "wrong" case.
- eg. for an excerpt named "MyExcerpt" none of the includes that include it by using the name "myexcerpt" will be found
- Users who override the auto-completion in the drop-down for setting the excerpt name in an include macro are subject to this problem.
If "Find Includes" is slow or returns HTTP 504 gateway timeout errors: