Add Hint for translators

17 files changed, 24 insertions, 14 deletions

diff --git a/templates/show_adds_catalog.inc.php b/templates/show_adds_catalog.inc.php
index c597353f..75c48c50 100644
--- a/templates/show_adds_catalog.inc.php
+++ b/templates/show_adds_catalog.inc.php
@@ -20,6 +20,7 @@
 */
 
 show_box_top();
+/* HINT: Catalog Name */
 printf(_('Starting New Song Search on %s catalog'), "<strong>[$this->name]</strong>"); 
 echo "<br />\n";
 echo _('Found') . ": <span id=\"add_count_" . $this->id ."\">" . _('None') . "</span><br />\n";
diff --git a/templates/show_artist.inc.php b/templates/show_artist.inc.php
index b2298d8f..942788af 100644
--- a/templates/show_artist.inc.php
+++ b/templates/show_artist.inc.php
@@ -19,9 +19,11 @@
 
 */
 $web_path = Config::get('web_path');
+/* HINT: Artist Fullname */
 $title = sprintf(_('Albums by %s'), $artist->full_name);
 ?>
 <?php
+/* HINT: Object type, Artist Fullname */
 show_box_top(sprintf(gettext('%s by %s'), ucfirst($object_type) ,$artist->f_name),'info-box');
 if (Config::get('ratings')) { 
 ?>
@@ -32,13 +34,13 @@ if (Config::get('ratings')) {
 <div id="information_actions">
 <ul>
 <li>
-	<a href="<?php echo $web_path; ?>/artists.php?action=show_all_songs&amp;artist=<?php echo $artist->id; ?>"><?php echo get_user_icon('view', _("Show All Songs By %s")); ?></a><?php printf(_("Show All Songs By %s"), $artist->f_name); ?>
+	<?php /* HINT: Artist Fullname */ ?><a href="<?php echo $web_path; ?>/artists.php?action=show_all_songs&amp;artist=<?php echo $artist->id; ?>"><?php echo get_user_icon('view', _("Show All Songs By %s")); ?></a><?php printf(_("Show All Songs By %s"), $artist->f_name); ?>
 </li>
 <li>
-	<?php echo Ajax::button('?action=basket&type=artist&id=' . $artist->id,'add',_('Add'),'add_' . $artist->id); ?><?php printf(_('Add All Songs By %s'), $artist->f_name); ?>
+	<?php /* HINT: Artist Fullname */ ?><?php echo Ajax::button('?action=basket&type=artist&id=' . $artist->id,'add',_('Add'),'add_' . $artist->id); ?><?php printf(_('Add All Songs By %s'), $artist->f_name); ?>
 </li>
 <li>
-	<?php echo Ajax::button('?action=basket&type=artist_random&id=' . $artist->id,'random',_('Random'),'random_' . $artist->id); ?><?php printf(_('Add Random Songs By %s'), $artist->f_name); ?>
+	<?php /* HINT: Artist Fullname */ ?><?php echo Ajax::button('?action=basket&type=artist_random&id=' . $artist->id,'random',_('Random'),'random_' . $artist->id); ?><?php printf(_('Add Random Songs By %s'), $artist->f_name); ?>
 </li>
 <?php if (Access::check('interface','50')) { ?>
 <li>
diff --git a/templates/show_clean_catalog.inc.php b/templates/show_clean_catalog.inc.php
index ba364ca6..71d3f24a 100644
--- a/templates/show_clean_catalog.inc.php
+++ b/templates/show_clean_catalog.inc.php
@@ -20,6 +20,7 @@
 */
 
 show_box_top();
+/* HINT: Catalog Name */
 printf(_('Cleaning the %s Catalog'), "<strong>[" . $this->name . "]</strong>");
 echo "...<br />"; 
 echo _('Checking') . ": <span id=\"clean_count_" . $this->id . "\"></span>\n<br />";
diff --git a/templates/show_democratic.inc.php b/templates/show_democratic.inc.php
index b5fb3405..bd8b22e7 100644
--- a/templates/show_democratic.inc.php
+++ b/templates/show_democratic.inc.php
@@ -18,6 +18,7 @@
  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
 */
+/* HINT: Democratic Name */
 $string = $democratic->is_enabled() ? sprintf(_('%s Playlist') ,$democratic->name) : _('Democratic Playlist'); 
 show_box_top($string); 
 ?>
diff --git a/templates/show_edit_catalog.inc.php b/templates/show_edit_catalog.inc.php
index 89621dc7..697d1137 100644
--- a/templates/show_edit_catalog.inc.php
+++ b/templates/show_edit_catalog.inc.php
@@ -19,7 +19,7 @@
 
 */
 ?>
-<?php show_box_top(sprintf(_('Settings for %s') , $catalog->name . ' (' . $catalog->path . ')')); ?>
+<?php /* HINT: Catalog Name */ show_box_top(sprintf(_('Settings for %s') , $catalog->name . ' (' . $catalog->path . ')')); ?>
 <form method="post" action="<?php echo Config::get('web_path'); ?>/admin/catalog.php" enctype="multipart/form-data">
 <table cellspacing="0" cellpadding="0">
 <tr>
diff --git a/templates/show_edit_shout.inc.php b/templates/show_edit_shout.inc.php
index 5f8c0a16..f232484c 100644
--- a/templates/show_edit_shout.inc.php
+++ b/templates/show_edit_shout.inc.php
@@ -25,7 +25,7 @@
 <input type="hidden" name="shout_id" value="<?php echo $shout->id; ?>" />
 <table class="tabledata" cellpadding="0" cellspacing="0">
 <tr>
-	<td><strong><?php printf(_('Created by: %s for %s'), $client->f_link, $object->f_link); ?></strong>
+	<td><strong><?php /* HINT: Client link, Object link */ printf(_('Created by: %s for %s'), $client->f_link, $object->f_link); ?></strong>
 <tr>
 <tr>
 	<td><strong><?php echo _('Comment:'); ?></strong>
diff --git a/templates/show_genre.inc.php b/templates/show_genre.inc.php
index 6e1ee56f..5c00fc1b 100644
--- a/templates/show_genre.inc.php
+++ b/templates/show_genre.inc.php
@@ -26,6 +26,7 @@
 */
 $web_path = Config::get('web_path');
 ?>
+<?php /* HINT: Genre Name */ ?>
 <?php show_box_top(sprintf(_('Viewing %s Genre'), $genre->name)); ?>
 		[<?php echo $genre->get_album_count(); ?>] 
 		<a href="<?php echo $web_path; ?>/genre.php?action=show_albums&amp;genre_id=<?php echo $genre->id; ?>">
diff --git a/templates/show_install.inc.php b/templates/show_install.inc.php
index 7c2bce79..afd68f33 100644
--- a/templates/show_install.inc.php
+++ b/templates/show_install.inc.php
@@ -19,9 +19,10 @@
  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 */
 if (INSTALL != '1') { exit; } 
+$dir = is_rtl($htmllang) ? 'rtl' : 'ltr';
 ?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $htmllang; ?>" lang="<?php echo $htmllang; ?>">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $htmllang; ?>" lang="<?php echo $htmllang; ?>" dir="<?php echo $dir;?>">
 <head>
 <title>Ampache :: For The Love Of Music - Install</title>
 <link rel="stylesheet" href="templates/install.css" type="text/css" media="screen" />
diff --git a/templates/show_ip_history.inc.php b/templates/show_ip_history.inc.php
index 8941c25d..dd86c7cb 100644
--- a/templates/show_ip_history.inc.php
+++ b/templates/show_ip_history.inc.php
@@ -20,7 +20,7 @@
 
 */
 ?>
-<?php show_box_top(sprintf(_('%s IP History'), $working_user->fullname)); ?>
+<?php /* HINT: Username */ show_box_top(sprintf(_('%s IP History'), $working_user->fullname)); ?>
 <div id="information_actions">
 <ul>
 <li>
diff --git a/templates/show_lyrics.inc.php b/templates/show_lyrics.inc.php
index 6b5af3b1..ed4cccc5 100644
--- a/templates/show_lyrics.inc.php
+++ b/templates/show_lyrics.inc.php
@@ -29,8 +29,9 @@
  *
  * @todo get lyrics from id3tag, if possible.
 */
+/* HINT: Song Title */
+show_box_top(sprintf(_('%s Lyrics'), $song->title));
 ?>
-<?php show_box_top(sprintf(_('%s Lyrics'), $song->title)); ?>
 <table class="tabledata" cellspacing="0" cellpadding="0">
 <tr>
 	<td>
diff --git a/templates/show_manage_catalogs.inc.php b/templates/show_manage_catalogs.inc.php
index 0ce9cdcc..fb6b671f 100644
--- a/templates/show_manage_catalogs.inc.php
+++ b/templates/show_manage_catalogs.inc.php
@@ -35,9 +35,9 @@
 </td>
 <td>
 	<form method="post" action="<?php echo Config::get('web_path'); ?>/admin/catalog.php?action=update_from">
-	<?php printf (_('Add From %s'), '<span class="information">/data/myNewMusic</span>'); ?><br />
+	<?php /* HINT: /data/myNewMusic */ ?><?php printf (_('Add From %s'), '<span class="information">/data/myNewMusic</span>'); ?><br />
 	<input type="text" name="add_path" value="/" /><br />
-	<?php printf (_('Update From %s'), '<span class="information">/data/myUpdatedMusic</span>'); ?><br />
+	<?php /* HINT: /data/myUpdatedMusic */ ?><?php printf (_('Update From %s'), '<span class="information">/data/myUpdatedMusic</span>'); ?><br />
 	<input type="text" name="update_path" value="/" /><br />
 <input type="submit" value="<?php echo _('Update'); ?>" />
 </form>
diff --git a/templates/show_playlist.inc.php b/templates/show_playlist.inc.php
index b7b4879a..96b4e9cd 100644
--- a/templates/show_playlist.inc.php
+++ b/templates/show_playlist.inc.php
@@ -23,7 +23,7 @@
  * It changes depending on where it is 
  */
 ?>
-<?php show_box_top(sprintf(_('%s %s Playlist'), $playlist->f_type, $playlist->name)); ?>
+<?php /* HINT: Playlist Type, Playlist Name */ show_box_top(sprintf(_('%s %s Playlist'), $playlist->f_type, $playlist->name)); ?>
 <div id="information_actions">
 <ul>
 	<li>
diff --git a/templates/show_preferences.inc.php b/templates/show_preferences.inc.php
index 1e2d7638..c12a34bb 100644
--- a/templates/show_preferences.inc.php
+++ b/templates/show_preferences.inc.php
@@ -25,7 +25,7 @@
  */
 
 ?>
-<?php show_box_top(sprintf(_('Editing %s preferences'), $fullname),'box box_preferences'); ?>
+<?php /* HINT: Username */ show_box_top(sprintf(_('Editing %s preferences'), $fullname),'box box_preferences'); ?>
 <?php  if ($_REQUEST['tab'] != 'account' && $_REQUEST['tab'] != 'modules') { ?>
 
 <form method="post" name="preferences" action="<?php echo Config::get('web_path'); ?>/preferences.php?action=update_preferences" enctype="multipart/form-data">
diff --git a/templates/show_rename_artist.inc.php b/templates/show_rename_artist.inc.php
index eb034966..72a591ae 100644
--- a/templates/show_rename_artist.inc.php
+++ b/templates/show_rename_artist.inc.php
@@ -26,7 +26,7 @@ function insert()
 	document.getElementById('artist_name').value = '<?php echo $artist->name; ?>';
 }
 </script>
-<?php show_box_top(sprintf(_('Rename %s'), $artist->name)); ?>
+<?php /* HINT: Artist Name */ show_box_top(sprintf(_('Rename %s'), $artist->name)); ?>
 <form name="rename_artist" method="post" action="<?php echo conf('web_path'); ?>/artists.php?action=rename&amp;artist=<?php echo $artist->id; ?>" style="Display:inline;">
         <?php show_artist_pulldown($artist->id, "artist_id", 4); ?>
 	<br />
diff --git a/templates/show_user_activate.inc.php b/templates/show_user_activate.inc.php
index 4b5b6cc0..c911c33b 100644
--- a/templates/show_user_activate.inc.php
+++ b/templates/show_user_activate.inc.php
@@ -48,6 +48,7 @@ $web_path = Config::get('web_path');
 <h3><?php echo _('User Activated'); ?></h3>
 <p>
 	<?php
+	/* HINT: Start A tag, End A tag */
 	 printf(_('This User ID is activated and can be used %sLogin%s'), '<a href="' . Config::get('web_path'). '/login.php">', '</a>'); ?>
 </p>
 <?php } else { ?>
diff --git a/templates/show_user_preferences.inc.php b/templates/show_user_preferences.inc.php
index a948a078..66aa5eca 100644
--- a/templates/show_user_preferences.inc.php
+++ b/templates/show_user_preferences.inc.php
@@ -25,7 +25,7 @@
  */
 
 ?>
-<?php show_box_top(sprintf(_('Editing %s preferences'), $client->fullname),'box box_preferences'); ?>
+<?php /* HINT: Editing Username preferences */ show_box_top(sprintf(_('Editing %s preferences'), $client->fullname),'box box_preferences'); ?>
 <form method="post" name="preferences" action="<?php echo Config::get('web_path'); ?>/preferences.php?action=admin_update_preferences" enctype="multipart/form-data">
 <table class="tabledata" cellspacing="0">
 <colgroup>
diff --git a/templates/show_verify_catalog.inc.php b/templates/show_verify_catalog.inc.php
index ab4a6a40..f3986fc7 100644
--- a/templates/show_verify_catalog.inc.php
+++ b/templates/show_verify_catalog.inc.php
@@ -20,6 +20,7 @@
 */
 
 show_box_top();
+/* HINT: Catalog Name */
 printf(_('Updating the %s catalog'), "<strong>[ $catalog->name ]</strong>");
 echo "<br />\n";
 printf(ngettext('%d item found checking tag information', '%d items found checking tag information', $number), $number);