Creating a Horde Module (App)
Please follow the instructions below and choose the version for which you'd like to start a new module. Once you have your first module you need to populate it with content. This will be the subject of the next section: <a href="https://wiki.horde.org/PopulatingYourFirstModule">PopulatingYourFirstModule</a>
Horde 5 (current)
- Prerequisites:<br />
Generate a horde checkout or get one using the Horde Developer Container<br />
(configure git-tools/config/conf.php first)<br />
/path/to/git-tools/bin/horde-git-tools git clone<br />
Setup an environment<br />
/path/to/git-tools/bin/horde-git-tools dev install<br />
Do basic horde initialization for dev (registry.local.php, conf.php)
- Create an app template<br />
/path/to/git-tools/bin/horde-git-tools dev new --app-name foo --author "My Name <<a href="https://wiki.horde.org/mailto:my.name@mycompany.com">my.name@mycompany.com</a>>"
- In /path/to/horde/config/registry.d/ create a file called newmodulename.php. Please note the documentation for available module entry options in horde/config/registry.php, especially the menu parent. If you want your module to go anywhere else in the menue, you will need to change this!
This is a "registry.d" example for Horde 5:
<pre><code class="language-php">
<?php
$this->applications['newmodulename'] = array(
    'name' => _("New Module"),
    // This is sufficient. More options possible if needed
);
</code></pre>
- If you wish you can provide your new module with a PNG icon at 20x20. This needs to be placed in the "themes" subdirectory:
<pre><code class="language-sh">
mkdir newmodulename/themes/default/graphics
cp newmodulename.png newmodulename/themes/default/graphics/
</code></pre>
This one is an example PNG from the basic horde application
<a href="https://github.com/horde/horde/raw/master/horde/themes/default/graphics/horde.png">https://github.com/horde/horde/raw/master/horde/themes/default/graphics/horde.png</a>
- To actually run your app boilerplate, you need to re-run the git-tools dev install procedure to create appropriate symlinks
Horde 5 (pre git split)
- Check out the skeleton module:
<pre><code class="language-sh">
 git clone --depth 1 https://github.com/horde/skeleton.git
 cd skelton
</code></pre>
- Start a new module - based on the Skeleton module - by running the following helper script:
<pre><code class="language-sh">
./bin/skeleton-generate-module newmodulename "Me Myself <me@myselfandi.com>"
</code></pre>
The new module will end up in skeleton's parent directory and have the name "newmodulename".
- Link or copy the new module into your horde installation.
<pre><code class="language-sh">
 ln -s `pwd`/../newmodulename /your/install/path/to/horde/
</code></pre>
Linking is the preferred variant as this allows you to work within the git repository and commit any code you write to a local branch. At the same time you have the installation ready for immediate testing of any changes.
- In /path/to/horde/config/registry.d/ create a file called newmodulename.php. Please note the documentation for available module entry options in horde/config/registry.php, especially the menu parent. If you want your module to go anywhere else in the menue, you will need to change this!
This is a "registry.d" example for Horde 5:
<pre><code class="language-php">
<?php
$this->applications['newmodulename'] = array(
    'name' => _("New Module"),
    // This is sufficient. More options possible if needed
);
</code></pre>
- If you wish you can provide your new module with a PNG icon at 20x20. This needs to be placed in the "themes" subdirectory:
<pre><code class="language-sh">
mkdir newmodulename/themes/default/graphics
cp newmodulename.png newmodulename/themes/default/graphics/
</code></pre>
This one is an example PNG from the basic horde application
<a href="https://github.com/horde/horde/raw/master/horde/themes/default/graphics/horde.png">https://github.com/horde/horde/raw/master/horde/themes/default/graphics/horde.png</a>
Horde 4
It is not recommended to use the Horde 4 Skeleton any longer.
- Check out the skeleton module from horde git
<pre><code class="language-sh">
 git clone --depth 1 git://github.com/horde/horde.git
 cd horde
 cp -R skeleton/ /your/install/path/to/horde/
</code></pre>
- Create the following script as projectrename.php - save it somewhere sensible, like your home directory:
<pre><code class="language-php">
#!/usr/bin/php -q
<?php
function analysedir( $path_, $list_ )
{
  // Read dir
  $handle = opendir($path_);
  while (false !== ($file = readdir($handle)))
  {
    if( $file!='.' && $file!='..')
    {
        $file = $path_ . DIRECTORY_SEPARATOR . $file;
        //echo "$filen";

        if( !is_dir( $file ) )  // If File: Append
        {
          $list_[count($list_)]=$file;
        }
        else   // If Folder: scan recursively
        {
          $list_ += analysedir($file, $list_ );
        }
   }
 }      // While END
 return $list_;
}

function substitute_skeleton( $filename, $modulname )
{
  $prjUC=strtoupper(trim($modulname));
  $prjLC=strtolower($prjUC);
  $prjMC=substr($prjUC, 0, 1) . substr($prjLC, 1, strlen($prjLC)-1);

  $filehandle=fopen(trim($filename), 'r');
  $file=fread($filehandle, filesize($filename));
  fclose($filehandle);
  $newfile=str_replace(array('SKELETON', 'Skeleton', 'skeleton'), array($prjUC, $prjMC, $prjLC), $file);
  $filehandle=fopen(trim($filename), 'w');
  fwrite($filehandle, $newfile);
  fclose($filehandle);
}

function help()
{
  echo "projectrename.php </path/to/skeleton-folder/> <modulname>n";
}

//
// ------------------- Main-Code --------------------
//

if (count($_SERVER['argv'])==3)
{
  // Preparation
  $list = array();
  $path = trim($_SERVER['argv'][1]);
  $modul = trim($_SERVER['argv'][2]);

  // Fetch Filelist
  $list = analysedir( $path, $list );

  // Modify each File
  foreach( $list as $file )
  {
        //echo $modul.": ".$file."n";
        substitute_skeleton( $file, $modul );
  }
}
else
  help();
?>
</code></pre>
- On a unix system, use the following command to replace all skeleton strings with your project name (Not tested on Windows, but should work):
<pre><code class="language-sh">
projectrename.php /path/to/skeleton modulname
</code></pre>
3.1:
Edit your Name into all files, for example with this snippet under bash (Unix, Linux or Windows with cygwin):
<pre><code>find ./ -type f -exec sed -i 's/Your Name <you@example.com>/Me Myself <me@myselfandi.com>/g' {} \;
</code></pre>
3.2 Rename
<pre><code>mv horde/appname/test/Skeleton horde/appname/test/Appname
</code></pre>
and
<pre><code>mv horde/appname/locale/skeleton.pot horde/appname/locale/appname.pot
</code></pre>
and
<pre><code>mv horde/appname/migration/1_skeleton_base_tables.php horde/appname/migration/1_appname_base_tables.php
</code></pre>
- Perform some file modifications:
<pre><code class="language-sh">
mkdir /path/to/modulename/themes/default/graphics
</code></pre>
- Upload a PNG icon at 16x16 named appname.png for the module to the path created above. This one is an example from the basic horde application:
<a href="https://github.com/horde/horde/blob/master/horde/themes/default/graphics/horde.png">https://github.com/horde/horde/blob/master/horde/themes/default/graphics/horde.png</a>
- In /path/to/horde/config/registry.d/ create a file called modulename.php. Please note the lack of ?> at the end of the php block, and also the menu parent. If you want your object to go *ANYWHERE ELSE* you will need to change this!
This is a registry.d example for Horde 4:
<pre><code class="language-php">
<?php
$this->applications['tickplug'] = array(
        'name' => _("Tickplug"),
        'provides' => array(
        'Tickets/Import'
        )
        // This is sufficient. More options possible if needed
    );
</code></pre>
- On the administration - configuration page, configure your app. (It won't display in the sidebar until you do.)
Horde 3
It is not recommended to use the Horde 3 Skeleton from CVS any longer. There is currently no usable version of Skeleton which is tagged FRAMEWORK_3. An older revision of the CVS HEAD version may work though.
This is a registry.d example for Horde 3:
<pre><code class="language-php">
<?php
$this->applications['modulename'] = array(
    'fileroot' => dirname(__FILE__) . '/../../modulename',
    'webroot' => $this->applications['horde']['webroot'] . '/modulename',
    'name' => _("A description of your module"),
    'status' => 'active',
    'menu_parent' => 'horde'
);
</code></pre>