Skip to content

Superior version of standard Folder Content Provider used in Widgetkit 2

License

Notifications You must be signed in to change notification settings

rvalitov/widgetkit-folder-ex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Version Widgetkit Widgetkit 3 Joomla Wordpress PHP7 YoothemePro

FolderEx Widgetkit Content Provider logo

Attention! This is a content plugin, not a widget! Follow the installation instructions carefully.

Notice about Widgetkit 3 and status of this project: Yootheme announced a third version of Widgetkit on January 26th, 2021. I received reports that after upgrade to Widgetkit 3 my widgets do not work properly. I'm very sorry that I currently not able to devote my time to this project to develop it further. In its current state it's "bug free" and works with Widgetkit 2 and Joomla 3. Currently, I don't have plans to add support for Widgetkit 3 or add any other serious improvements. This project has been my pet project that I was doing in my free time, and I've been happy to share it for free with the community. As I stopped using Widgetkit in my own websites, I lost motivation in further updates to this project. I'm happy if my work and widgets were of any help or use in your websites!

Overview

FolderEx is a Content Provider plugin for Yootheme Widgetkit2. It's a superior version of a standard Folder Content Provider that allows to use files as items for a widget. After installation it becomes available for any standard or custom widgets. Especially the FolderEx is optimal for use with image related widgets, for example:

Features

For detailed information, please refer to the manual. Quick comparison between Folder and FolderEx is here.

Basic Features

  • Select a source folder - it's a directory that contains files that will be used as a source for content items of a widget.
  • Ordering options - the files can be sorted in direct and reverse order alphabetically, by modification date and randomly.
  • Limit number of items - the maximum number of files that will be loaded can be limited.
  • Backward compatibility - all other behavior, styling and features of the original Folder Content Provider are preserved.
  • Use with your existing data - you can easily convert your existing widgets to use FolderEx as a content provider.

Unique Features

The new features that the FolderEx has and that are not available in the original Folder Content Provider:

  • Sophisticated Filtering - complete freedom to apply any filtering of files using RegExp patterns, read more.
  • Better control of titles - more options are available to control how the titles are created from the file names, e.g. replacement of dashes and/or underscores into space character.
  • Non Latin characters in file names - you can name the files as you want in your native language, using non Latin characters, e.g. accents or Cyrillic characters. For example: équipe.jpg, Животное.jpg, Übergabe.jpg.
  • Offset - defines how many images should be skipped from the start. See Use Case: Large Galleries with Lots of Photos
  • Tooltips for all options - it's much easier to use the widget, because tooltips are available for all settings.
  • Update notifications - you will be notified if new versions of the plugin are available.
  • Multilingual interface, translated into languages:
    • English (en_GB)
    • Русский (ru_RU)
    • Deutsch (de_DE)
    • Your language not listed? You can help with translation, read more.

Supported platforms

  • The initial code is based on Widgetkit 2.7.3 and was updated if necessary. It should work with any Widgetkit 2.4.x and later (recommended 2.5.0+). Tested in Widgetkit 2.7.x, 2.8.x, 2.9.x.
  • The following CMS are supported:
    • Joomla 3.4.x or later. Tested in Joomla 3.4.x, 3.5.x, 3.6.x.
    • Wordpress 4.4.x or later

Read full system requirements here.

How to install?

The installation procedure is described here.

The manual

The manual is available in the Wiki area.

Authors, Contributors and Acknowledgment

Disclaimer

This project is NOT affiliated with, endorsed, or sponsored by the Yootheme. Widgetkit, its name, trademark, and other aspects of the app are trademarked and owned by their respective owners.

Feedback

Your feedback is very appreciated. If you want to see new features in this module, please, post your ideas and feature requests in the issue tracker.

Donations

This is a free project that I do in my spare time. If you find it useful, then you can support it by donating some amount of money. This will help to keep the project alive and making it better: develop new features, make new releases, fix bugs, update the manuals, and provide at least some minimal technical support (there's an issue tracker here).

You can choose any payment method you prefer:

Your Currency Payment Method
Euro € Card PayPal
USD $ Card PayPal
Russian Ruble ₽ Card PayPal YandexMoney
Other Card PayPal

Support or Contact

Having trouble with FolderEx Content Provider? May be something has already been described in the Wiki area or reported in the issue tracker. If you don't find your problem there, then, please, add your issue there.

Being a free project which I do in my spare time, I hope you understand that I can't offer 24/7 support:) You may contact me via e-mail [email protected], I will try to answer to all of them (if such messages imply an answer), however, not immediately, it may take a few days or a week... so, just be patient.

Note, that I can answer only to questions and problems directly related to FolderEx plugin. Answers to basic questions about the widgetkit nature and simple help about how to use widgets in general or how to use Joomla you can find in appropriate forums: