DOCman Secrets: Brief permissions

DOCman 1.5 has a unique permission system allowing you to divide up your documents and categories in such a way that you can deliver them securely and efficiently. One question I’m often asked in my daily role as Support Engineer on the forums is how to get these permissions right.

I took the time and put together a video that outlines a common permission scheme.

Imagine you need to build a school website and they want to make documents available to their students and staff. Of course the students are not allowed to access documents of the staff. While all staff people are registered users, students are a mix between registered users and guests.

Read more

DOCman Security Announcement

Joomlatools would like to announce the immediate availability of DOCman 1.5.8 and DOCman 1.4.1.

Recently a medium level vulnerability was discovered in DOCman. A user with editing permissions can potentially access confidential data. The following versions of DOCman are affected: 1.3.x, 1.4.x up to 1.4.0.stable, 1.5.x up to 1.5.7. Upgrading to either 1.4.1 or 1.5.8 resolves the issue.

Even though this is only a medium level vulnerability that will only affect a small percentage of sites, we recommend everybody to upgrade as soon as possible.

Read more

DOCman Secrets: Email notifications

Whether you are running an intranet or a public website, as an administrator, you often need to keep a close eye on what your users are doing. Especially when they are allowed to edit documents or upload new files. With DOCman Notify, it’s easy to set up email notifications. Notify is part of the DOCman Productivity Pack. Tom made another great video tutorial, showing how it’s done.

Watch the DOCman Notify 1.5 Video.

  1. Install the plugin iusing Joomla’s extension installer
  2. Go to the Plugin Manager and edit the plugin’s settings
  3. Don’t forget to enable the plugin. If you want turn of notifications later, just disable it again
  4. In the “Send to” field, enter your email address
  5. If you want to send to multiple recipients, separate the email addresses with the pipe symbol “
  6. Turn on the notifications you wish to receive. The first three options will send an email whenever a user uploads, edits or downloads a document in the front-end of your site. The last option notifies you when a manager or (super) administrator edits a document through the backend interface.
  7. Save the plugin settings
  8. Try one of the upload, edit or download actions that you enabled
  9. Check your inbox. The email contains all kinds of useful info about the user, the document and the file.

Get the DOCman Productivity today in the Joomlatools Store, for only €15

Advanced customization

If you don’t like the look of the email, or you want it to have a different set of information, you can easily do so by modifying the email template. The /plugins/docman/notify/templates folder contains two php files, one for the email body and one for the footer. They contain standard html and css, plus a couple of php variables. If you have some html experience, you should have no problem editing these to your liking.

It’s your workflow

Every organization has their own workflow needs. DOCman’s flexible plugin system allows developers to add workflow rules and behavior to DOCman, and in fact, DOCman Notify is great example to start from. We’d love to hear how you use DOCman, and how you would like to see it improved.

Read more

DOCman Secrets: Generating thumbnails

Did you know that you don’t need to worry about creating thumbnails for your images or other documents yourself? All you need is the DOCman Thumbs plugin, which does all the work for you. It’s part of the DOCman Productivity Pack. This video shows how easy it is:

Watch the DOCman Thumbs 1.5 video.

  1. After installing, remember to enable DOCman Thumbs in the Plugin Manager
  2. You can adjust some settings, for example the thumbnail dimensions
  3. Now when you browse the frontend, the thumbnails are generated on the fly for all supported file types (depending on your server setup)
  4. If a document already has a thumbnail (for example because you set it manually), it will not be overwritten

Clearing thumbnails

If you want to start over (for example after changing the thumbnail size), you’ll need to clear out the thumbnails.

  1. Go to the DOCman Home screen
  2. Click ‘Clear Data’
  3. Select ‘Thumbnails’ and click the ‘Clear’ button
  4. Note that this will clear the thumbnails for **all **your documents

Advanced use

By default, most server setups have the GD library installed. This will work fine for standard images such as png and jpg. But if you want thumbnails for larger files, pdf’s, movies, and range of other documents{#rj:d}, you’ll need to install some libraries, such imagick{#aevm} and ghostscript. If you are not familiar with installing libraries on your server, please ask your system administrator for help. To find out what is already available on your server, go to Help -> System Info -> PHP Information.

Read more