Template Overrides

The standard output from any Joomla Module or Component can be overridden by adding code to the html directory of your template.

Note: DOCman fully supports the Joomla template override mechanism.

Template files

Templates can be found in /components/com_docman/views/[name]/tmpl and can be overridden by copying the template to your Joomla template’s html folder.

Our Framework documentation provides more in-depth information about template overrides.

Template overrides are also explained in almost every Joomla developer book.

Media assets

The media assets can be found in the /media/com_docman

The best way to find out how an element is being styled would be to use the Elements panel in Google Chrome DevTools. This will show you the styles of the elements you want to change and in what file they can be found. You can then override them by adding override styles to your template. 

Creating CSS Overrides

Add the following snippet to your custom CSS file to change the icons to 32x32 pixels:

body .koowa.koowa .com_docman .koowa_header__image,
body .koowa.koowa .com_docman [class^="k-icon-"],
body .koowa.koowa .com_docman [class*=" k-icon-"],
body .koowa.koowa .com_docman [class^="k-icon-"]:before,
body .koowa.koowa .com_docman [class*=" k-icon-"]:before {
    width: 32px;
    height: 32px;
    font-size: 32px;
    line-height: 32px;
    max-width: 32px;
    max-height: 32px;
}

More examples can be found in our Icon Sizes documentation.

FAQ’s

How do I display documents above my categories in list views?

You need to override components/com_docman/views/list/tmpl/default.html.php. For table lists use table.html.php.

Find the following two blocks of code and swap them:

<? // Sub categories ?>
<? if ($params->show_subcategories && count($subcategories)): ?>
...
<? endif; ?>
<? // Documents header & sorting ?>
<? if (count($documents)): ?>
...
<? endif; ?>

How to change the frontend document form?

You need to override the file at components/com_docman/views/document/tmpl/form.html.php.

In any of the document list views you may want to change the behavior of the thumbnail links. By default clicking on the document thumbnail displays a larger version of it in a lightbox, but you can change the link to either download the document or redirect the user to the document details page. Here is how you can do it:

First override the file at components/com_docman/views/document/tmpl/document_default.html.php

For document to download after clicking the thumbnail, simply remove the following code snip:

<?= helper('behavior.thumbnail_modal'); ?>

Then if you want the user to go to the document details page after clicking on the thumbnail, find the following code snip:

<a class="docman_thumbnail thumbnail" href="<?= $document->image_download_path ?>">
    <img itemprop="thumbnailUrl" src="<?= $document->image_path ?>" alt="<?= escape($document->title); ?>" />
</a>

and replace $document->image_download_path with $document->title_link which is the path to the document details page.

Test your customization by uploading a document with a thumbnail and then clicking on the thumbnail in the front-end.

How to change the thumbnail size?

DOCman automatically generates a 512x512 thumbnail for each document file. DOCman reduces their size using CSS when displaying it. This means that you can control the thumbnail size using a CSS override.

Add the following snippet to your custom CSS file and set the max-width and min-width property to your desired thumbnail size:

body .koowa.koowa .com_docman .docman_thumbnail {
    max-width: 40%;
    min-width: 50px;
}

How to remove a field?

You need to override the file at components/com_docman/views/document/tmpl/form_publishing.html.php.

First find the field you want to remove. If you would like to remove the Owner field. Find the line that starts with <div class="k-form-group"> above the Owner label.

Removing the following snippet will remove the Owner field:

<? if (!isset($hide_owner_field)): ?>
<div class="k-form-group">
    <label><?= translate('Owner'); ?></label>
    <?= helper('listbox.users', array(
        'name' => 'created_by',
        'selected' => $document->created_by ? $document->created_by : object('user')->getId(),
        'deselect' => false
    )) ?>
</div>
<? endif; ?>

Note: Users can still change the owner by modifying the form before submitting it.

Need Help?

Let our developers personally assist you. You can ask development related questions in our Support Center. Only for Business or Agency subscribers.