themeに書き込んだリンクがうまくいかない

通常のHTMLでのリンクは、絶対パス（サイトルートを起点に/スラッシュで始める記述法）や相対パス（自分のファイルを起点に../等で始める記述法）で記述されますが、XOOPSでは様々な階層のページで、同じデザインテーマを利用し画面を出力していますので、独自のルールが必要です。

例：aboutというモジュール名称のトップページへリンクしたい場合。


のように記述します。
<{$xoops_url}>は、Smartyコードと呼ばれるもので、XOOPSが画面の最終HTMLを出力する際に、これを定義された値に変換します。
<{$xoops_url}>には、mainfile.phpであなたが指定したサイトのルートURLが代入されます。

絶対パスでも動作するという場合もありますが、もしサイトルート以外にXOOPSをインストールする場合は有効になりませんので、ルールに基づいて記述することをお勧めします。