Category Archives: Luca Ferrario

ACL management in oneye 0.8

ACL support has been greatly improved with the latest oneye SVN commits by s0600204. He has also written an excellent tutorial I’m going to post here, so you can all take advantage of it!

Before reading it, please consider these important notes:

  • Latest SVN commits have improved both the mechanisms and the GUI of ACL management. Having oneye SVN 7358 or subsequent is a requirement for all the procedures mentioned in the tutorial. You can find an howto about upgrading your oneye system to latest SVN here);
  • Setting wrong ACLs can damage your oneye system and make it unavailable. Please always back up your data and test your ACL modifications on a testing oneye installation before using it in production;
  • Normal users are not allowed to see and edit ACLs on an oneye system. So this tutorial is obviously targeted at oneye system administrators only;
  • This tutorial is a draft and maybe it will be modified in the future. Please always be sure to have latest version. Current version is: draft2 – 02/28/2012

Ready? Here you are the tutorials!
ACL management in oneye 0.8 [English]
ACL management in oneye 0.8 [French – translated by Sable]
ACL management in oneye 0.8 [Italian – translated by fasenderos]

How to start developing applications in oneye

Hi all!
I was glad to see in the forum that there are some people who would like to start developing oneye applications (or maybe even integrate new functions in the OS or fix some bugs), so I want to suggest you the first step to become an oneye developer:

  1. First of all, you need to have a good PHP knowledge, since oneye is written in PHP, and at least a few basics of Javascript.
  2. Download and read the eyeOS 1.x Developer Manual. It’s quite old, so it misses a lot of the new functions available to developers, but it’s extremely useful for a newbie to understand the oneye structure, essential to start programming;
  3. I strongly suggest you to use the Firefox browser with the Firebug plugin. In order to see the applications error messages directly in Firebug, you have to set the EYEOS_DEBUG_MODE to 3 in /eyeOSxxxxxxx/system/conf/system.xml;
  4. Start trying to modify the HelloWorld app, included in all oneye releases;
  5. While you program, never forget to always have a look at the greatest friend of the oneye developer: the eyeOS 1.x Documentation Center. Also, you could find useful the eyeOS 1.x Wiki. Remember that both have not been updated for some releases, so you’re not going to find all the functions…. But you can find the largest part! For the others, while you’ll become a better oneye programmer, you’ll learn to look by yourself into the code to find the functions. TIP: all the widgets are in the /eyeOSxxxxxxx/system/lib/eyeWidgets/widgets folder;
  6. For question, always use the current oneye Development Forum. Also keep in mind that you can find a lot of useful resources on the old eyeos Development Forum (always check that the question refers to eyeOS 1.x and not eyeOS 2.x, since the latter has a completely different structure).
  7. If you’re thinking about writing an application starting from zero….please check that there is not another one in the eyeOS 1.x Application Repository. If there is one similar, maybe you can try to improve it, instead of writing one from scratch!
  8. Hey, all here is open-source….if you manage to write a good application, please publish it on the Repository!

So….have fun writing apps! 🙂

PS = Updating the documentations is a huge work, but it makes life easier for all the developers interested in contributing to the project. If you’d like to help updating it, please reply to this topic on the forum.

How to download the latest oneye SVN

Hello everybody,
it can be useful for you to know the simple steps to install on your server the latest oneye SVN version, to have a look at all the new features that have been implemented since the latest release, so here I write a very short tutorial.
Please note that SVN snapshots are not supported by the team, so don’t expect the release version to have automatic updaters from the SVN snapshots! If you find a bug, please report it using the appropriate section of the forum!
So, here you are the 6 simple steps:

  1. Download the latest oneye SVN tarball;
  2. Uncompress the tarball and move all the content of the “1.9” folder inside the folder that you want to be the eyeos installation root;
  3. Rename the “eyeOS” folder to a name which is enough difficult to guess for a user but not exagerated long, as for example “eyeOS43h49d98g8jdfn”;
  4. Now edit /settings.php adjusting the REAL_EYE_ROOT constant to the folder name you just chose at point 3. In case you wish to use the “real” VFS module instead of the “virtual” default one, please also change the VFS_MODULE constant;
  5. Now edit /eyeOSxxxxxxx/system/conf/system.xml and set EYEOS_DEBUG_MODE from 3 to 0 (unless you are a developer and you want to keep the debug mode on). You can leave all the other configurations to their default value, since you will be able to change them from the oneye system, via the System preferences;
  6. You are ready! Please make sure that the oneye folder and all the files are writable by the web server user and then go with your browser to the new installation URL, login with “root/root”, open the System preferences, change the root password and edit all the configurations to fit your needs! If you have questions, please ask them on the forums.