Joomla! module tinyDoc
tinyDoc is a module for Joomla! 2.5.x / 3.x / 4.x to display the documents managed by the tinyDoc component.
The highly configurable output includes an file-type dependant icon, the document name, description, filesize and download link.
License
tinyDoc is published under GNU/GPLv3
System Requirements
- Joomla! 2.5.x / 3.x / 4.x
- PHP 5.x or newer (0.8+ tested up to PHP 8.x)
Install
Download the module using the link at the end of this page and install it using the Joomla! Extension Manager.
Uninstall
Uninstall the module by using the Joomla! Extension Manager. Don’t forget to remove all references to the tinyDoc module afterwards!
Usage
To add a new document list, open the Joomla! Module Manager and click “New”.
Select “tinyDoc” from the list of available modules.
On the module screen, enter a title for the module and either enter a new position for the module or select an already existing one.
Configure the basic module options
- folder: folder containig the documents you want to display
- description: show document description
- size: show document size
- date: show document date
- date format: strftime compatible string, without the leading ‘%’
- sort by: sort documents by either date, description, name or size
- sort order: sort order can be ascending or descending
- CSS classes: classes to assign to the tinyDoc table, head and rows
- custom layout: define custom layout (see below)
If you don’t select a folder, a corresponding message will appear.
Show documents within articles
To show a list of documents within an article, use the “loadposition” function.
Assign a unique position to the module and use
{loadposition my_unique_position}
in the text to include the list.
Custom layout
After enabling the custom layout option, the contents of the “custom layout” boxes will be used instead of the standard table layout. There are several tags that can be used:
- ###date###: file date
- ###description###: file description
- ###icon###: file icon, determined by file type (path relative to web root)
- ###name###: file name
- ###size###: file size
- ###url###: URL for file download
To show the files as an ordered list, enter
<ol>
in the “custom layout start” box and the corresponding
</ol>
in the “custom layout end” box and finally use something like
<li><a href="###url###">###name###</a> (###date###, ###size###)<br />###description###</li>
in the custom layout item box. The contents in the “item” box will be used in a loop to for each item to display.
Multiple folders
tinyDoc is able to display the contents of several folders in one article by either
- adding multiple modules to a page using the “loadposition”-statement or
- creating a parent (master) folder which contains the other folders and use this folder for the module
Disclaimer
This software is provided as is without any guarantees or warranty.
Use at OWN risk!
Download
Download and usage is not recommended for new installations.
Download (mod_tinydoc v0.8 for Joomla! 4.x; ZIP-archive; 11kB)
Download (mod_tinydoc v0.7 for Joomla! 3.x; ZIP-archive; 10kB)
Download (mod_tinydoc v0.5.1 for Joomla! 2.5.x; ZIP-archive; 10kB)
Changelog
0.8 [2024-05-10]:
- initial release for Joomla! 4.x
- changed: URL of update file (rewrite for old URL is in place)
- info: no code changes from 0.7
0.7 [2017-09-21]:
- added: option to limit number of documents
- added: option to select all folders (’***')
- changed: default stylesheet
- final release for Joomla! 3.x
0.6 [2014-11-02]:
- initial release for Joomla! 3.x
0.5.1 [2013-06-04]:
- fixed: set default layout type to ‘standard’ if value is not set
- final release for Joomla! 2.5.x
0.5 [2013-06-04]:
- added: custom layout mode
0.4.1 [2013-06-03]:
- fixed: Warnings in PHP strict mode
0.4 [2012-08-09]:
-
added: manual sort order
-
info: compatibility-upgrade for com_tinydoc 0.5
0.3 [2012-07-20]:
- info: compatibility-upgrade for com_tinydoc 0.3; will not work with older com_tinydoc releases
0.2.2 [2012-07-09]:
- fixed: module was missing ‘index.html’-file in some folders
0.2.1 [2012-07-08]:
- fixed: date format got lost between releases 0.1 and 0.2
0.2 [2012-07-05]:
- added: tinyDoc now supports updates using the Joomla! Extension Manager
- changed: license is now GNU/GPLv3
0.1 [2012-06-18]:
- initial release
I have downloaded and installed the tinydoc component and module. However after I upload a document it isn’t showing up in the documents.
Any thoughts?
Thanks,
Tom
Thanks,
Tom
just read your report. What document size are you trying to upload?
Regards,
-andreas
Thanks for TinyDoc and this module. They’re a perfectly simple and functional solution. I have one big problem though. The module parameters don’t include folder or description for me. This makes it all kind of useless, but this is obviously not intended behavior. Any advice?
Dankeschön!
{loadposition my_unique_position} in an article
e.g. {loadposition centerpos-22}
What should come up here?
Nothing happens at my site (blank, not even the {loadposition xx) text.)
Regards, Julie
Please check that the module is enabled and that there are no typos in the name of the position.
Hope this helps!
This is a brilliant module and I only have two suggestions;
1. It would be useful to be able to sort Folders by order to enable the user to place them in the order he wants, rather than by date or name, etc.
2. It would be useful if sub-folders appeared under their primary folder name in hierarchal order.
Best wishes,
David
I would like to work with tinyDoc but would need to be able to search through the documents managed with it - is that possible or upcoming?
Best,
Martin
thanks for the suggestion. Adding manual ordering will be quite some work to do but might be added in a future release.
Looks like a great component (and module). But before installing I wondered if it includes the functionality to link a main menu item direct to a file too. I guess that are work arounds such as using external link and linking to the file directly. But I was hoping an inbuilt solution may offer a better url path.
using the current 0.3 release, an external link is indeed the only way to link a menu item to a file. The feature will be added to the upcoming 0.4 release of the tinyDoc component which should be out in a few days. Thanks for the suggestion!