Category Archives: oneye

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.

Integrate webapps into oneye via eyeIframize

I’m sure that some of you don’t know the power of eyeIframize, a great application of oneye/eyeOS series 1.x.
With eyeIframize, even a kid can integrate an existing webapp into oneye in a minute. Since eyeOS SVN 7258, eyeIframize supports 5 input parameters, while before it only supported one, the URL. These parameters are:

  1. URL: If not specified, a dialog will appear asking the user the address and all the following parameters will be ignored
  2. TITLE: This is the title of the Window. If not specified or set to 0, it will default to “eyeIframize”
  3. WIDTH: The window width, in pixels. If not specified or set to 0, it will default to 75% of the eyeApp screen width
  4. HEIGHT: The window height, in pixels. If not specified or set to 0, it will default to 75% of the eyeApp screen height
  5. START MAXIMIZED: If it is set to 1, the window will be opened maximized (100% of eyeApp screen area). If the user presses the maximize button of the window, it will be resized to WIDTH and HEIGHT, if they have been specified (otherwise, it will be resized to 75% of the screen area)

To take advantage of the improved eyeIframize, you can either install the patch on your existing eyeOS 1.9.x installation, or make a brand new install, by downloading the latest eyeOS 1.x SVN. If you use the original eyeOS 1.9.x eyeIframize you can still open iframes, but you can’t specify the title and the window size.

For example, to integrate Wikipedia into oneye, you just have to right click on an empty space on your oneye desktop and choose “New launcher”:

  

In the command line, I typed: eyeIframize.app http://www.wikipedia.org Wikipedia 900  500 1
So my application will open the page http://www.wikipedia.org, will have the title “Wikipedia” and will be opened maximized. 900 and 500 pixels is the size of the window if the user presses the “Maximize” button of the window.

On the desktop we have now the Wikipedia launcher and the site is perfectly integrated into the oneye system:

   Â