Zencart Plugin Framework – Day 2 – Configuration and Plugin Installation

On day 1, I have introduced to your our new Zencart Plugin Framework, what you will get from it and how to install it, today I will cover the configuration of the framework and how to install plugins written for it. Boy, this will be a short day because installation of plugins using ZePLUF will be so simple.


Right now, the only configuration file you should be worried about is settings.yaml, this file already has the notes for each configuration but I will explain them in more details here (YAML is a user friendly configuration file. Unlike PHP or XML, YAML is actually readable and understandable for users who have no programming background. Note that you never use “tab” in a YAML file, always use “spaces” instead. Read more about YAML here)

  preload: [riCore, riSsu, riCache, riCart, riUtility, riLog, riSession]

Unlike Zencart’s default framework which does not have the concept of “plugins” and so doesn’t allow you turn plugin on or off easily, with ZePLUF you can easily turn on/off plugins any time you like. The global config here will tell ZePLUF to load these plugins on both front and back ends in the order specified.

  preload: [riOrder, riCustomer, riZCAdmin, riCsv, riInventoryReport]

the list of plugins to load on backend only, in the order specified.

  preload: [riFilter]

the list of plugins to load on frontend only, in the order specified.

  translator: { fallback: en }

you only need this if you use multiple languages

Plugin Installation

Installing a plugin that was CODED FOR ZePLUF is quite easy, if the plugin was coded to our standard then you will simply have to copy it to the plugins folder and then you may need to edit the settings.yaml above to turn it on and that’s it.
For some plugins, you may need to edit some Zencart files (this is the limitation of Zencart itself)

Today, I will show how to install one of our famous plugins: Simple Seo Url which does have a version coded for Zencart so you can have an idea:

  1. Download the module from github, make sure you get the ZePLUF branch
  2. Put the files and folders you downloaded into plugins\riSsu
  3. Simply edit 1 file as instructed in the readme
  4. Goto admin – extras – Plugin Manager to install and activate SSU
  5. Done


  1. Dan says:

    Hi again!
    I am sorry for being such a “pain in the ass” but today I tried to install it on two stores, one is 1.3.9h and the other 1.5, and in both I get the same error:
    Call to a member function read() on a non-object in /plugins/riSsu/lib/cores/Link.php on line 459
    I tried to remove it but there are many others. And also, there’s no link in extras to ssu in either store. Thank you!

    • admin says:

      No problem, I welcome all questions. It seems like I missed the riCache plugin when I packaged the ZePLUF package. You can get it here: https://github.com/yellow1912/riCache. Please let me know if it helps.

      • Dan says:

        Well, I added both riCache and riCategory and it started to work, kind of. I still cannot access modules from the admin panel, I get – PHP Fatal error: Uncaught exception ‘Symfony\Component\Routing\Exception\ResourceNotFoundException’ in /zenmagick/vendor/symfony/src/Symfony/Component/Routing/Matcher/UrlMatcher.php:96
        and many others.
        And it does not validate, I get a bunch of redirects. So I guess I wont be able to pull it off without your professional installation. Where can I order it?
        Thank you!

        • Raine Ng says:

          Very very weird, it seems like you are missing a few components. Is razgon…. your email address? I will contact you directly there



Leave a Reply