andreas michael thul
Musik & Technik

Joomla! module tinyDoc

Dieser Artikel ist in Ihrer Sprache nicht verfügbar.

tinyDoc is a module 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! CMS 2.5.x or 3.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.

Disclaimer

This software is provided as is without any guarantees or warranty.

Use at OWN risk!

Changelist

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
  • 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

Download

mod_tinydoc for Joomla! 2.5.x (ZIP-archive; 10kb)

mod_tinydoc for Joomla! 3.x (ZIP-archive; 10,1kb)

Links

tinyDoc in the Joomla! Extension Directory

16 Kommentare

  1. Hi,

    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

    • Hi Tom,

      just read your report. What document size are you trying to upload?

      Regards,
      -andreas

    • Hi Andreas, 15mb pdf file. Is that too large – or a hosting issue?
      Thanks,
      Tom

      • Most likely a hosting issue. Please check the values of ‘upload_max_filesize’ and ‘post_max_size’ in your ‘php.ini’. Default value should be 8M.

  2. This is a great module and component. I think it would be a great plus if it has an option for searching documents or filtering.

  3. Thank’s for the component it’s very helpfull

  4. 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!

  5. Works great, except:

    {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

    • The {loadposition …} should have been replaced by the output of the module.
      Please check that the module is enabled and that there are no typos in the name of the position.

      Hope this helps!

  6. Dear Andreas,

    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

  7. Hi Andreas,

    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

    • Right now, a search function is not available but might be included in a future release.

  8. Hi I’ve just tested it and would love to also see manual ordering in the module.

    • Hi,
      thanks for the suggestion. Adding manual ordering will be quite some work to do but might be added in a future release.

  9. Hi Andreas,
    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.

    • Hi Sonia,
      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!

Kommentar schreiben