DOCman List Content Plugin Version: 2.7.7 Copyright (C) 2010-2015 Omar Ramos, orware networks. All rights reserved. License GNU/GPL, see LICENSE.php Legend: # -> Bug Fix + -> Addition ! -> Change - -> Removed ! -> Note 2.7.7 2016-04-16 / Omar Ramos + Added ability to perform natural case category sort (Option Keys: useCategoryDefaultSort, useCategoryNaturalSort) + Added ability to perform natural case document sort (Option Keys: useDocumentDefaultSort, useDocumentNaturalSort) ! Natural case sorting is useful for when you have numeric values in your Category or Document Titles and want them to be sorted the way a human might sort them since by default the database tends to sort them incorrectly (e.g. 10, 11, 100, 50, 70 would be the default result and 10, 11, 50, 70, 100 would be the natural sort result). 2.7.6 2015-04-24 / Omar Ramos + NEW Document Filetype Inclusion Capability (Allows you to filter documents by filetype you want to include) (Option Keys: setDocumentFiletypeInclusionFilters pdf,doc,etc.) + NEW Document Filetype Exclusion Capability (Allows you to filter documents by filetype you want to exclude) (Option Keys: setDocumentFiletypeExclusionFilters pdf,doc,etc.) 2.7.5 2015-04-22 / Omar Ramos + NEW Category Inclusion Capability (Allows you to filter category names you want to include) (Option Keys: setCategoryInclusionFilters Word1,Word2,etc.) + NEW Category Exclusion Capability (Allows you to filter category names you want to exclude) (Option Keys: setCategoryExclusionFilters Word1,Word2,etc.) + NEW Document Inclusion Capability (Allows you to filter document names you want to include) (Option Keys: setDocumentInclusionFilters Word1,Word2,etc.) + NEW Document Exclusion Capability (Allows you to filter document names you want to exclude) (Option Keys: setDocumentExclusionFilters Word1,Word2,etc.) + NEW List Specific Documents feature (allows DOCman List to function a little like DOCman's Document Editor Button Plugin, but in this case you just provide the Document IDs and it will list the files with whatever DOCman List Layout you'd like to use from my plugin). (Option Keys: listSpecificDocuments 43,87,80,56,58) # Fixed an issue with the "table_labels_in_columns" layout (the table header for when the New column was displayed wasn't being added) 2.7.4 2015-04-21 / Omar Ramos + Improved the support for DOCman 2.1's new Access Level/Group Permissions Feature (before this update, some of these were not being captured correctly by the plugin so data was not being displayed correctly). 2.7.3 2015-04-20 / Omar Ramos # Fixed an issue with the "get all folders" method working under certain conditions 2.7.2 2015-04-19 / Omar Ramos + Improved the Asset Rule Preloading Capability which greatly improves loading speed on large sites (on the site I used for testing prior to the change it was taking about 45 seconds to load the page using my older method for Preloading, now it only takes about 10 seconds...and this is with about 750 files and 34 categories being displayed on the same page). + NEW Layout: Standalone Cart - The standalone cart integrates a ZIP Download Feature so your users can download multiple files at once. It's similar to the table/nested table layouts, except there is a column of checkboxes that allow users to select the files they wish to download. Beneath every list there are "Download Selected Files" and "Clear Selections" buttons. (Option Keys: useStandaloneCartLayout, useNestedStandaloneCartLayout) + Added "show categories owned by user" feature. (Option Keys: showOwnCategoriesList, showNormalCategoriesList) + Added "show documents owned by user" feature. (Option Keys: showOwnDocumentsList, showNormalDocumentsList) + Added Ability for Owner Status to be Displayed on Categories. (Option Keys: showCategoryOwnerLabel, hideCategoryOwnerLabel) + Added Ability for Owner Status to be Displayed on Documents. (Option Keys: showDocumentOwnerLabel, hideDocumentLabel) + Added Ability for Published/Unpublished Status to be Displayed on Categories. (Option Keys: showCategoryStatusLabel, hideCategoryStatusLabel) + Added Ability for Pending/Expired/Unpublished Status to be Displayed on Documents. (Option Keys: showDocumentStatusLabel, hideDocumentStatusLabel) # Fixed an issue I noticed when saving articles that contained DOCman List code in the backend when Smart Search was enabled for a site (it caused an error in one of the files where the regular DOCman code was being used and was behaving differently than it does in the frontend). 2.7.1 2015-04-16 / Omar Ramos (Hotfix Release) # Fixed issue with DOCman 2.1 (a change had been made at the database level that caused the plugin to stop retrieving data correctly). 2.7.1 2015-03-14 / Omar Ramos + Added new feature for Submitting Files to Menu Items that have been manually created by users (using the DOCman "Submit Document" Menu Type). ! This is only used as a fallback feature in the case that the regular Submit File links won't be added automatically for a category. 2.7.0 2015-03-11 / Omar Ramos # Fixed a bug where the jQuery Library wasn't being included correctly to support Delete operations properly in Joomla 2.5 + Added keepalive behavior when logged into a page using DOCman List (this helps keep the session alive so you don't run into an "Invalid Cookie Token" error when trying to use the Delete button for a file. 2.7.0 2015-01-17 / Omar Ramos ! This is a minor point release where I integrated some custom work I had performed for a client. + Added a new Cart layout that can be used together with my mod_downloadqueue module (allows you to queue up multiple files for download when using DOCman List). (Option Keys: useCartLayout/useNestedCartLayout) 2.6.9 2014-12-23 / Omar Ramos # Fixed SqueezeBox Conflict Issue (If a prior SqueezeBox/Modal had already been added to the page it overrides the plugin's version so I added a more foolproof way within the plugin output. # Fixed Joomlatools kQuery include issue (looks like older versions of DOCman 2.0 may have had a koowa.kquery.js file which has been more recently renamed to koowa.jquery.js) 2.6.8 2014-12-15 / Omar Ramos # Fixed Force Download Feature for Files (the URL parameter had changed from an underscore to using a dash: force-download) + Added ability to turn on Category Description Content Plugin processing + Added the Delete button capability in (DOCman 2.0 had changed the process so I needed to wait to know how to add it back in to the plugin) + Investigate if it is possible to show hits on the Documents now in DOCman 2.0 stable + Added Search Capability + Added modal link ability back in + Added "Copy to Clipboard" functionality option 2.6.7 2014-09-22 / Omar Ramos # Needed to make an additional correction in the itemid.php class file (The Joomlatools Select Query format had changed and resulted in a PHP error) 2.6.6 2014-08-31 / Omar Ramos ! Needed to modify all calls to KService which is no longer usable with the DOCman 2.0 stable version. ! Additionally, some method names were changed, and/or completely removed 2.6.5 2014-03-01 / Omar Ramos # Fixed issue with the Category Filtering Feature when "Hide Parent Category" was Turned On. # Fixed the JavaScript for the regular (non-nested) layouts. Previously the Expand/Collapse functionality was being triggered even on Categories that did not have any files (so a Category would end up hiding the Category immediately beneath it, which wasn't correct) # Fixed an issue where my DocmanRouterHelper::preloadCategoryPaths() method was being called statically even though it wasn't declared as a static method. + Added the ability to show/hide the Details Link (Option Keys: showDetailsLink/hideDetailsLink) + Added the ability to show/hide the Category Name (Option Keys: showCategoryName/hideCategoryName) ! Tweaked the way the new "Hide Expand Icons" feature works (now it hides the spacer as well so the Category Name lines up better with the file listing 2.6.4 2014-02-15 / Omar Ramos + Added the ability to show/hide the Category Folder icons (Option Keys: showCategoryIcons/hideCategoryIcons) + Added the ability to show/hide the Filetype Icons (Option Keys: showFiletypeIcons/hideFiletypeIcons) + Added the ability to show/hide the +/- Icons to Expand/Collapse the Categories (Option Keys: showExpandIcons/hideExpandIcons) + Added the ability to show direct category links to the right of the Category Title...this would be useful if you have Category Links turned off for regular users, but may want to show them for logged in users that have permission to upload (Option keys: showCategoryLinksToUsersWithPermissions, hideCategoryLinksToUsersWithPermissions) + Added the ability to use Forced Download Links at any time (Option Keys: useForcedDownloadLinks/useDefaultLinks) + Added a CSS fix to remove the Category block being highlighted if you click on it multiple times quickly to Expand/Collapse the hierarchy ! Modified the render method for the non-nested layouts so that categories with sub-categories would not be treated as "empty" ones (this fixed an issue where if you did not have any files yet, all categories would be hidden when showCollapsed was turned on). # Fixed a bug in docmanlist.js that was triggered by trying to expand/collapse empty categories # Fixed a bug in sorttable.js for Joomla 3 (the updated version of Mootools no longer has the $defined function but there's a simple correction that can be made to fix that) ! Added in code that allowed Joomla 2.5/3 code to be triggered (allowing us to go back to a single package for both versions). 2.6.3 2013-11-29 / Omar Ramos # Fixed an issue detecting the primary DOCman menu item with newer RC versions of DOCman 2.0 # Fixed an issue detecting the proper DOCman storage folder when detecting file sizes (previously I had the default folder hard coded in) + Added in manual calls to make sure the Mootools Framework is included before adding in the DOCman List JavaScript (it seems on some sites now Mootools is no longer available so this addition is needed). 2.6.2 2013-07-10 / Omar Ramos # Fixed an Issue with the "New" Label (I'm not longer using the default 7 Day setting within DOCman 2.0 and instead allow you to set the number of days you want files to be considered "New" in the plugin) + Added new "table_labels_in_columns" and "nestedtable_labels_in_columns" layouts which show the New, Edit, Download/Details, and Locked By columns in individual columns. 2.6.1 2013-07-04 / Omar Ramos ! Happy 4th of July :-) # Just tested with DOCman 2.0 RC1 and noticed there was a Fatal Error due to a class name change for RC1. Added some code to detect this and do the right thing so the plugin can run on either the Beta or RC properly. 2.6.0 2013-03-13 / Omar Ramos ! Please note that this release DOES NOT work with the older DOCman 1.6.x version since there were too many changes required to do so. I will be releasing an updated version of the DOCman List 2.5.x plugin that contains some of the new features I've brought in with the 2.6.0 version. + Big New Feature: DOCman 2.0 Compatibility. + Performed a major code cleanup to make it easier to add new parameters and Option Keys + Added additional Option Keys for existing parameters + Moved the parameter labels/descriptions into the Language file so that they can be translated (if anyone cares to do so, feel free to send me your translations to support@orware.com). + Added in 4 New Layouts: Image Columns, Image List, Simple File List and Simple File List with CSS3 Columns + Added in the ability to use regular template overrides so you can create your very own custom DOCman List Layouts! Simply place your own custom versions of the layouts (or even create new ones) in: templates/your_template/html/plg_content_docmanlist/ ! Simplified way of creating nested layouts + Added in ability for Document Thumbnail to be displayed in table layouts or in the Title Hover ToolTip + Reworked the data retrieval methods for DOCman 2.0 so that DOCman List can retrieve document/category information efficiently. + Created new classes to make generating SEF URLs more efficient + Created new class to make retrieving the Asset Rules for Document/Category more efficient + Created new "Demo" mode that you can use by adding in the showDemo Option Key. Provides a nice way to present the information contained about the parameters, along with all of the Option Keys available in DOCman List, in a way you can print out more easily for yourself or others. + Added ability to turn the Submit Files links On/Off + Added ability to turn the "New!" labels for Documents/Categories On/Off + Added ability to display a File Extension column/value + Added in ability to override the default PHP Execution Time and Memory Limit if your web host allows doing so via PHP. This can help if you have a few DOCman List pages that are outputting a lot of content and need the extra time/memory. + Added in support for Wildcard Category Filters (prior to this you could only specify an exact match to filter out). So now you could do something like 15:Board* to filter out any subcategories that start with the word "Board" of Category ID = 15. + Added in ability to filter out Categories with spaces in the title (I noticed spaces would cause an incorrect result). So now you could do something like 15:Board of Trustees and the "Board of Trustees" subcategory should be filtered out from Category ID = 15. + Added in additional checks to process DOCman List code more effectively (sometimes TinyMCE/JCE would add in HTML in odd places that would break things so I'm trying to handle that transparently for you guys). + Added in ability to filter out Categories with spaces in the title ! The showMenu option doesn't currently show the Search or Submit Files, but it still allows you to link to the DOCman Main Page. ! Reorganized the File Parameters and Grouped them...hopefully this makes the configuration screen a little more user friendly. - Removed Modal View Link Option (wasn't working correctly in the new version) - Removed the View Link (DOCman 2.0 simplifies the available links so I only have the Download/Details/Edit links currently) ! I'm sure there are probably a few things I've forgotten, but all in all it's a pretty major release! Enjoy! 2.5.4 2012-09-04 / Omar Ramos + Added code changes to the table with preview layout + Added simple JavaScript to close iframe in table with preview layout by clicking again on the title (works fairly well) + Added detection for when your docmanlist tags are surrounded by paragraph tags added by your editor (paragraph tags are automatically removed). 2.5.0 2012-04-12 / Omar Ramos + Added new feature to show DOCman Category ID if you hover over the category name (nested categories/table layouts only) + Added new feature to display Submit File button when logged in and you have upload permissions (nested categories/table layouts only) # Fixed potential issue for servers running PHP 5.3 (fatal error, which is tough to troubleshoot called by DocmanRouterHelper class not being loaded) ! Confirmed compatibility with Joomla 2.5.4+ 1.7.2 2011-09-13 / Omar Ramos # Fixed the showMenu option (path to image folder and language keys were incorrect) # Fixed an issue when using the showCollapsed option (it wouldn't reset the auto expand levels parameter to 0) ! Changed the left margin for the nested list items in the nestedtable layout from 10px to 15px (seems to improve the look when expanding the items) 1.7.1 2011-09-12 / Omar Ramos # Fixed an issue where using docmanlist multiple times in a single page resulted in cloned output (instead of different output). # Fixed an issue with the new optional caching parameters (wouldn't work properly when manually enabled, since the optional parameters would not have been processed when the cache was retrieved) 1.7.0 2011-09-08 / Omar Ramos + Added new manual caching layer for generated output (use forceCachingOn or forceCachingOff when adding the docmanlist code to your pages) 1.5.9 2011-07-24 / Omar Ramos + Added a new layout: You can now have your folders output more like they would be on your filesystem (Corresponding key when calling plugin: useNestedTableLayout) + Added a new layout: Same as the above one, but just doesn't include the files in the output (Corresponding key when calling plugin: useNestedCategoriesLayout) + Added new CSS code that makes the output HTML displayed more compact. You can enable/disable this option as needed if you'd like to revert back to the older output (enabled by default) (Corresponding key when calling plugin: useNewCSS, useOldCSS) + Added ability for categories with zero files to have the category count hidden (Corresponding keys when calling plugin: showEmptyCategoryCount, hideEmptyCategoryCount) + Added ability for the folders to be expanded to a particular level automatically (only applicable to the new Nested Table / Nested Categories layouts) + Added ability for folders to be displayed before files (prior to this the output has been the opposite...only applicable for the new Nested Table / Nested Categories layouts) + Added ability for folders to be expanded by clicking on the

category heading as well as the +/- image ! Changed Zebra striping to use CSS3 nth-child selector instead of the row1 class (also added zebra striping for the nested layouts) # Added a fix for people using jxtended Finder (the plugin was using JPATH_BASE instead of JPATH_ROOT, so if called from the backend the plugin would run into a fatal error # Fixed the table output for the table and nestedtable layouts (the within each tag was missing the corresponding tag which resulted in invalid output) 1.5.8 2010-11-10 / Omar Ramos + Added a new layout: select dropdown lists (initial version...still needs input/work) (Corresponding key when calling plugin: useDropdownLayout) + Added a new layout: categories (now you can simply display only the categories if you'd like...the layouts make use of this one) (Corresponding keys when calling plugin: useCategoriesLayout) + Added more robust file extension support (added in all icons from default DOCman template and added support for a generic image to be used when no appropriate icon is available) + Added check to see if a document has been checked out, if it has then the Check-in link is displayed in lieu of displaying the Update link + Added ability to hide empty categories (Corresponding keys when calling plugin: showEmptyCategories, hideEmptyCategories) + Added ability to configure the date display format (for those that want to be more detailed and show the time as well as the date or just want to display the date differently). + Added ability for the category count to be displayed (Corresponding keys when calling plugin: showCategoryCount, hideCategoryCount) ! Note: Happy 235th Anniversary United States Marine Corps! 1.5.7 2010-11-02 / Omar Ramos + Added language files for Dutch and Danish languages directly into the plugin (should be installed automatically). Please forgive my use of Google Translate for the new language keys introduced in 1.5.6...if any corrections are needed please let me know. + Added modal popup capability for view links in table and list layouts. (Corresponding keys when calling plugin: useModalViewLinks, useNormalViewLinks). # Fixed backwards compatiblity issue introduced with version 1.5.6 where empty categories were removed from the listing (compared to being shown before). Now only categories which you do not have access to will not be shown. # Fixed PHP warning for $filters variable # Fixed issue where an extra slash was added for a parent category which you did not have access to was shown (e.g. / / Agendas) 1.5.6 2010-10-30 / Omar Ramos + Added support for my preload() method within the DocmanRouterHelper class (so if you copy over my custom router.php file into components/com_docman then the number of queries needed when SEF is enabled should be greatly reduced). + Added canUpdate() method to DOCmanListHelper class. + Added the canUpdate() text into the layouts. + Added some additional language keys into the language file. + Added some additional configuration options for the menu buttons (now you can turn on/off each of the Downloads Home, Search Documents and Submit Files buttons as well as use a custom URL for the Downloads Home link). + Added some additional text that gets displayed when you install the plugin to make sure and inform users that they should go and Enable the plugin if they are installing it for the first time. + Added ability for custom height/width to be used for the table layout with preview Layout Option. # Fixed issue Wes was running into by creating a modified copy of the getDocsByUserAccess() method to the DOCmanListHelper class. # Fixed issue that loaded all documents when the preloadDocumentsGroupedByCategory() method was called with an empty value for $catIds. ! Note: Still need to fix PDF focusing issue reported by Remco in the table layout with preview layout. ! Note: Need to add in modal layout option. 1.5.5 2010-10-17 / Omar Ramos ! Moved Default Table Layout into its own file (Corresponding key: useTableLayout) + Added New List Layout (Corresponding key: useListLayout) + Added New Table with Preview Layout (Corresponding key: useTableLayoutWithPreview) + Completely reworked the data retrieval portion of the plugin to preload data in chunks, rather than load records one by one. + Added Category Primary Field Ordering Capability (Corresponding keys: categoryOrderByName, categoryOrderByParentId, categoryOrderById, categoryOrderByOrdering along with categoryOrderAscending, categoryOrderDescending) + Added Category Secondary Field Ordering Capability (Corresponding keys: categoryOrderByNone2, categoryOrderByName2, categoryOrderByParentId2, categoryOrderById2, categoryOrderByOrdering2 along with categoryOrderAscending2, categoryOrderDescending2) + Made some additional CSS improvements 1.5.4 2010-09-30 / Omar Ramos # Fixed Download Link issue caused by my original implementation of the "# Fixed an issue where if you had disabled the "Show Download" link" below from version 1.5.3. 1.5.3 2010-09-25 / Omar Ramos - Removed ability for server's current file size for a file to be used (since it seems like DOCman doesn't actually store like I was thinking...it appears to be getting the value live so this feature isn't exactly needed). # Fixed an issue where the showMenu parameter was not having any effect when the option had been turned off globally within the plugin configuration (I accidentally had the call to add the menu after I reset the parameters back to the global defaults). # Fixed an issue where if you had disabled the "Show Download" link within the DOCman Standard Buttons plugin the links in the plugin output would not point to the files (added a direct call to create the Download link that doesn't depend on the Standard Buttons Plugin). 1.5.2 2010-09-25 / Omar Ramos + Added ability for server's last update time to be used, rather than the value stored within DOCman (useful for those uploading documents via FTP). Thank you d2drummer! (Corresponding keys when calling plugin: useSystemUpdateTime, useDocmanUpdateTime). + Added ability for server's current file size for a file to be used, rather than the value stored within DOCman (useful for those uploading documents via FTP). + Added ability to remove the "/" (forward slash) character from being displayed before the Category Name. Thanks d2drummer! (Corresponding keys when calling plugin: showForwardSlash, hideForwardSlash). + Added ability for Category Names to not be linked directly to their category page (instead, just the name is displayed with no link). Thanks marbz! (Corresponding keys when calling plugin: showCategoryLinks, hideCategoryLinks). + Added ability for the Downloads Home, Search Documents, and Submit Files buttons (normally only available on the actual DOCman Component Page) to be displayed by the plugin. Thanks r2bmanag! (Corresponding keys when calling plugin: showMenu, hideMenu. You may also simply use {docmanlist showMenu} to display the menu once wherever you'd like and leave this option disabled.). # Fixed an issue where a document's with a large amount of description text would get their tooltips displayed in awkward ways (added some additional CSS to limit the height/width of the tooltip). ! Changed the single category output so that the user can choose to display that category's parent hierarchy or not. (Corresponding keys when calling plugin: showSingleCategoryHierarchy, hideSingleCategoryHierarchy). 1.5.1 2010-09-19 / Omar Ramos # Fixed bug where   would cause the plugin display to break + Added Uploaded By Field (Thanks Saso!) ! The Uploaded By Field can be configured to display either the user's full name or their username + Added Show/Hide Options for each of the following columns: Size, Added On, Last Updated On, Uploaded By, and Downloaded - Removed some unnecessary member variables within the file + Made categories containing files collapsible + Reduced query usage slightly (unfortunately, the built-in DOCman methods I'm using generate a lot still) + Added ability to display document description in a mootools tooltip when hovering over the document name + Added ability to change parameters on the fly when calling the plugin using the following keywords (case-sensitive): orderByName, orderByDate, orderByHits, orderAscending, orderDescending, showTooltip, hideTooltip, showSize, hideSize, showAddedOn, hideAddedOn, showLastUpdatedOn, hideLastUpdatedOn, showUploadedBy, hideUploadedBy, showUsersActualName, showUsername,showDownloaded, hideDownloaded, showExpanded, showCollapsed. + Added automatic parameter reset capability (otherwise, after changing the parameters dynamically in one call, subsequent calls to the plugin will continue to use the same settings). 1.5.0 2010-08-15 / Omar Ramos # Added in additional check for when the $filter variable is empty (prevents an in_array warning notice)