Change App name

[MarkSD]

Hi There,

I hope that one of you can help me as I have trying to resolve this issue for days.

I have installed egroupware 1.8 and am happy with the setup, except that I need to change the name of the Home app. I have changed it’s content so that it redirects to a sub-page. I therefore now need to change its name from Home (the blue home link under the icon) to the name of the sub-page. I have seen some articles about translation tools etc, but none of them are very clear. I literally just need to change the name displayed under the icon. Is there a simple way that I can do this?

Thanks in advance for your help.

Mark

[MarkSD]

Hi guys - does anyone have any advice on this one? I’m sure it must be simple to do for people in the know?

Thanks again,

Mark

[alarbiere]

It is actually pretty easy to rename an application using the translation tools.

In your case, to rename the Home app, go the the “Translation Tools” app, then, on the line for the Home application, click the Edit button.
You will see a line showing the Original name “Home” with the Translation being whatever it would be in your selected language. If your language is English it will show the same name “Home”.
Modify that translated value to the name you want your users to see, then click the Save button at the end of the list (in the section entitled Step #2, then click the Write button on the Target language line in the Step #3 section.
As eGroupware does cache quite a number of things, I found that changes won’t show up until you go to the Admin App and click “Clear cache and register hooks”, then log out and login again.

Andre

[MarkSD]

Hi Andre,

Thank you for your response. That does sound very easy, but perhaps I am in the wring place or simply have the wrong version of egroupware. This is the community version of 1.8. I am trying the following:

Login to egroupware setup
Click Language management
Click Manage Languages
Do I then click on only add a new phase?

Or am I in completely the wring place? Perhaps translations tools is something specific that doesn’t come with 1.8 community or maybe I need to install it from somewhere?

Thanks again for your help.

Mark

[Andre_Larbiere]

Hi Mark,

No, that’s not the right place to look for this.
You will need to make sure that you have installed the “developer-tools” application in setup -> manage applications. And, of course, you will also need to give yourself access to that application.

When you have done that, and you login to the standard eGroupware interface (so NOT the setup page) you will find a couple of new icons (or menu item in the overflow menu). One is “eTemplate”, the other is “Translation Tools”. You will need to access that second one.
Note that both of these applications have the potential of making your eGroupware installation unusable, so you should be very careful about whom you give access to those.

In the translation tools app you can modify strings in any of the installed languages, including the default English.

regards,
Andre

[MarkSD]

Hi Andre,

Thank you for your advice. I have added translation tools now and logged in to make the changes. Below is what I see:

I don’t seem to have a write option. Should this be enabled somewhere?

Sorry to keep bugging you with this one. I realise that the questions that I am asking are probably quite simple.

Mark

[Andre_Larbiere]

Oh yes, you will also need to make sure that your web server can write to files named egw_XX.lang in the ./lang sub-directories of each application (or at least for the home application, so /var/www/egroupware/home/lang/egw_en.lang)

The web server user (e.g. on a Debian server that would be www-data), should have write access to the lang sub-directory and all files within that. Easiest way to achieve that is to make www-data the owner of those files. Of course that’s not the safest thing to do, so you might want to do that only temporarily…
On my server that directory looks like this:
root@vs3593 :/var/www/egroupware/home/lang# ls -al
total 108
drwxr-xr-x 3 www-data www-data 4096 Apr 15 13:40 .
… some lines removed …
-rw-r–r-- 1 www-data www-data 186 Apr 15 11:15 egw_en.lang
… some more lines removed …
root@vs3593 :/var/www/egroupware/home/lang#

Normally, the Write button would appear behind the Download button, but since the web server can’t write the file anyway, the button is suppressed.
When you have fixed that, give it another try. If you still don’t see any text below the “Original” column, try clicking on the “Search new phrases” button, and accept any strings that will be shown on the next screen.
You should eventually see the same screen, with both Original and Translation showing the same string on each row, and a coupld of Write buttons displayed in the Step #3 section.

No problem with asking questions… I’m using the community version, too, and if I can pay back a bit by helping others, than that’s fine.

Please feel free to post back how things go.

Andre

[MarkSD]

Hi Andre,

Thank you for all your help. I think it’s nearly there. I changed the lang file permissions and the system then let me see the write button and correct text (see below image), however the menu link for the home icon still says Home. I have logged out and back in again and even restarted my server (which is ubuntu by the way).

I think this is nearly there. I’m obviously still missing one thing though.

Mark

[Andre_Larbiere]

Have you also cleared the cache?
Admin --> Clear cache and register hooks (in Sidebox menu)

[MarkSD]

I don’t seem to have that option in my admin menu (see below):

[Andre_Larbiere]

Sorry, my fault. Forgot that you are running 1.8 (I use the current trunk, which will be the future 1.9 - it has this new menu item in the Admin application - very handy when you’re tweaking all the time )

The change should eventually show up (as the cache expires). If you don’t want to wait, you can clear it manually.
Here’s how you can do that:

on your server locate the directory that you have configured in eGroupware setup -> edit current configuration as the directory for temporary files. If you haven’t moved that to a different place, it will most likely be /tmp

There should be directory named “egw_cache” there. Simply delete that using a command like “rm -r egw_cache”. If you don’t trust that this won’t hurt your eGroupware installation, you can also just rename it, e.g. “mv egw_cache egw_cache.gone”. Once you are confident that everything works fine, you can then remove the “.gone” version…
eGroupware will respond a bit more sluggily as the cache is rebuild, but there won’t be any other effect.

Andre

[MarkSD]

Thanks again Andre - very nearly there I think.

I renamed the egw_cache file in tmp and checked that it recreated it. I then logged back in to egroupware, but Home is still called Home

Very confusing!

Mark

[Andre_Larbiere]

Probably yet another difference between 1.8 and the upcoming 1.9 - I think some things were changed in the translation handling which allows application specific translations to superseed those of the base API.

Change the “Home” label for the “phpgwapi” application (actually the foundation of eGroupware itself). It will probably show up as “EGroupware API” in translation tools (I think that was already the name for 1.8).
You will again need to make sure that www-data has write access on /var/www/egroupware/phpgwapi/lang/*

Note that the string list for phpgwapi is quite long… I suggest using the browser’s search function to find the string “Home” on that page (on my server this is close to the middle of the page).

Note that on my svn trunk installation, I can change the “Home” label either for the eGroupware API or for the Home application itself. In both cases it will show the new name on the menu. That’s why I suggested changing it for the Home application only, as that’s just a list of 5 strings…

Andre

[MarkSD]

Hi Andre,

Great troubleshooting. I followed your suggestions and it is now fixed

Thanks again for all of your help and have a great week

Mark