functions.php

<?php
// From plugin LocaleSwitcher.

/**
 * Convert a standard locale string (en_US) into the language and region.
 *
 * @param string $locale
 * @param boolean $justLanguage
 * @return string
 */
function locale_human($locale, $justLanguage=false)
{
    $parts = explode('_', $locale);
    if (isset($parts[1])) {
        $langCode = $parts[0];
        $regionCode = $parts[1];
        $language = Zend_Locale::getTranslation($langCode, 'language');
        $region = Zend_Locale::getTranslation($regionCode, 'territory');
    } else {
        $region = '';
        $language = Zend_Locale::getTranslation($locale, 'language');
    }
    if ($region != '') {
        $region = " - $region";
    }

	if (!$justLanguage) {
		return ucfirst($language) . $region;
	} else {
		return ucfirst($language);
	}
}

/**
 * Get the related translated record (page or exhibit) from a record.
 *
 * @param Omeka_Record_AbstractRecord $record
 * @param string $locale
 * @return SimplePagesPage|Exhibit|ExhibitPage|null The translated record if exists.
 */
function locale_record($record, $locale = null)
{
    return locale_record_from_id_or_slug(get_class($record), $record->id, $locale);
}

/**
 * Get the related translated record (page or exhibit) from a record id or slug.
 *
 * @param string $recordType
 * @param int|string $recordIdOrSlug The record id if numeric, else a slug.
 * @param string $locale
 * @return SimplePagesPage|Exhibit|ExhibitPage|null The translated record if exists.
 */
function locale_record_from_id_or_slug($recordType, $recordIdOrSlug, $locale = null)
{
    static $currentLocale;

    if (empty($locale)) {
        if (is_null($currentLocale)) {
            $currentLocale = Zend_Registry::get('bootstrap')->getResource('Locale')->toString();
        }
        $locale = $currentLocale;
    }

    $translated = get_db()
        ->getTable('MultilanguageRelatedRecord')
        ->findRelatedSourceRecordForLocale($recordType, $recordIdOrSlug, $locale);
    return $translated;
}

/**
 * Return the HTML for summarizing a random featured exhibit
 *
 * @see exhibit_builder_display_random_featured_exhibit()
 *
 * @return string
 */
function locale_exhibit_builder_display_random_featured_exhibit()
{
    $html = '<div id="featured-exhibit">';
    $featuredExhibit = locale_exhibit_builder_random_featured_exhibit();
    $html .= '<h2>' . __('Featured Exhibit') . '</h2>';
    if ($featuredExhibit) {
        $html .= get_view()->partial('exhibits/single.php', array('exhibit' => $featuredExhibit));
    } else {
        $html .= '<p>' . __('You have no featured exhibits.') . '</p>';
    }
    $html .= '</div>';
    $html = apply_filters('exhibit_builder_display_random_featured_exhibit', $html);
    return $html;
}

/**
 * Return a random featured exhibit.
 *
 * @see exhibit_builder_random_featured_exhibit()
 *
 * @return Exhibit|null
 */
function locale_exhibit_builder_random_featured_exhibit()
{
    return get_record('Exhibit', array(
        'featured' => 1,
         'sort_field' => 'random',
    ));
}

/**
 * Get the translated url from the url of an exhibit or a simple page.
 *
 * @todo Manage simple pages and exhibit pages with a "/" in the slug.
 *
 * @param string $url A standard Omeka url (/items/show/xxx, /exhibit/show/yyy…).
 * @return string The translated url or the original one.
 */
function locale_convert_url($url)
{
    // The url may be an exhibit or an exhibit page.
    if (($pos = strpos($url, '/exhibits/show/')) !== false) {
        $idOrSlug = substr($url, $pos + 15);
        if ($idOrSlug) {
            // If there is another "/" inside the url part, it's an exhibit page.
            if (strpos($idOrSlug, '/') === false) {
                $translated = locale_record_from_id_or_slug('Exhibit', $idOrSlug);
                if ($translated) {
                    $url = record_url($translated);
                }
            } else {
                $translated = locale_record_from_id_or_slug('ExhibitPage', $idOrSlug);
                if ($translated) {
                    $url = record_url($translated);
                }
            }
        }
    }
    // The url may be a simple page.
    elseif (strpos($url, '/items/show/') === false
        && strpos($url, '/collections/show/') === false
        && strpos($url, '/files/show/') === false
    ) {
        // Get the last part of the url.
        $slugUrl = explode('/', $url);
        $slug = array_pop($slugUrl);
        if ($slug) {
            $translated = locale_record_from_id_or_slug('SimplePagesPage', $slug);
            if ($translated) {
                $url = record_url($translated);
            }
        }
    }
    return $url;
}