MediaWiki:ImageAnnotatorConfig.js

// <source lang="javascript">
 
/*
  Site-wide configurations and start of the ImageAnnotator gagdet. Split into a
  separate file for three reasons:
  1. It separates the configuration from the core code, while still
  2. making it impossible for someone else (e.g. a malicious user) to override these
     defaults, and
  3. makes configuration changes available quickly: clients cache this file for four hours.
 
  Author: [[User:Lupo]], September 2009
  License: Quadruple licensed GFDL, GPL, LGPL and Creative Commons Attribution 3.0 (CC-BY-3.0)
 
  Choose whichever license of these you like best :-)
 
  See //commons.wikimedia.org/wiki/Help:Gadget-ImageAnnotator for documentation.
*/

(function ()
{
  var wgUserGroups = window.wgUserGroups;

  // Global settings. Edit these to configure ImageAnnotator for your Wiki. Note: these configurations
  // are here to prevent them to be overwritten by a user in his or her user scripts. BE EXTRA CAREFUL
  // IF YOU CHANGE THESE SETTINGS WHEN IMAGEANNOTATOR IS ALREADY DEPLOYED! Syntax or other errors here
  // may break ImageAnnotator for everyone!
  var config = {

    // By default, ImageAnnotator is enabled in all namespaces (except "Special", -1) for everyone,
    // except on the project's main page.
    // Here, you can define a list of namespaces where it is additionally disabled.
    viewingEnabled : function ()
    {
      return mw.config.get('wgNamespaceNumber') >= 0
             && !mw.config.get('wgIsMainPage') // Disable on the main page
             && (mw.config.get('wgAction') && (mw.config.get('wgAction') == 'view' || mw.config.get('wgAction') == 'purge' || mw.config.get('wgAction') == 'submit')); 
    },
    // For instance, to disable ImageAnnotator on all talk pages, replace the function body above by
    //     return (mw.config.get('wgNamespaceNumber') & 1) == 0;
    // Or, to disable it in the category namespace and on article talk pages, you could use
    //     return (mw.config.get('wgNamespaceNumber') != 14) && (mw.config.get('wgNamespaceNumber') != 1);
    // To enable viewing only on file description pages and on pages in the project namespace:
    //     return (mw.config.get('wgNamespaceNumber') == 6) || (mw.config.get('wgNamespaceNumber') == 4);
    // To enable viewing only for logged-in users, use
    //     return wgUserName !== null;
    // To switch off viewing of notes on the project's main page, use
    //     return !mw.config.get('wgIsMainPage')

    // By default, editing is enabled for anyone on the file description page or the page that contains
    // the substitution of template ImageWithNotes. Here, you can restrict editing even more, for
    // instance by allowing only autoconfirmed users to edit notes through ImageAnnotator. Note that
    // editing is only allowed if viewing is also allowed.
    editingEnabled : function ()
    {
      var pageView = mw.config.get('wgAction') && (mw.config.get('wgAction') == 'view' || mw.config.get('wgAction') == 'purge')
                     && document.URL.search (/[?&](diff|oldid)=/) < 0;
      if (!pageView) return false;
      if (!wgUserName) return false; // User not registered
      return wgUserGroups
          && / (autoconfirmed|sysop|bureaucrat) /.test (' ' +  wgUserGroups.join (' ') +  ' ');
    },
    // To allow only autoconfirmed users to edit, use
    //     return wgUserGroups &&
    //            (' ' + wgUserGroups.join (' ') + ' ').indexOf (' autoconfirmed ') >= 0;
    // The following example restricts editing on file description pages to autoconfirmed users,
    // and otherwise allows edits only on subpages in the project namespace (for instance, featured
    // image nominations...), but allows editing there for anyone.
    //     return (   (   mw.config.get('wgNamespaceNumber') == 6
    //                 && wgUserGroups
    //                 && (' ' + wgUserGroups.join (' ') + ' ').indexOf (' autoconfirmed ') >= 0
    //                )
    //             || (mw.config.get('wgNamespaceNumber') == 4 && mw.config.get('wgPageName').indexOf ('/') > 0)
    //            );
    // Note that wgUserName is null for IPs.

    // If editing is allowed at all, may the user remove notes through the ImageAnnotator interface?
    // (Note that notes can be removed anyway using a normal edit to the page.)
    mayDelete : function ()
    {
      return true;
    },

    // If the user may delete notes, may he or she delete with an empty deletion reason?
    emptyDeletionReasonAllowed : function ()
    {
      if (!wgUserGroups) return false;
      var groups = ' ' + wgUserGroups.join (' ') + ' ';
      return groups.indexOf (' sysop ') >= 0 || groups.indexOf (' rollbacker ') >= 0;
    },

    // If the user may delete, may he or she bypass the prompt for a deletion reason by setting
    // var ImageAnnotator_noDeletionPrompt = true;
    // in his or her user scripts?
    mayBypassDeletionPrompt : function ()
    {
      if (!wgUserGroups) return false;
      return (' ' + wgUserGroups.join (' ') + ' ').indexOf (' sysop ') >= 0;
    },

    // If viewing is enabled at all, you can specify here whether viewing notes on thumbnails (e.g.,
    // in articles) is switched on. Logged-in users can augment this by disabling viewing notes on
    // thumbnails on a per-namespace basis using the global variable ImageAnnotator_no_thumbs.
    thumbsEnabled : function ()
    {
      return true;
    },
    // For instance, to switch off viewing of notes on thumbnails for IPs in article space, you'd use
    //     return !(namespaceNumber == 0 && wgUserName === null);

    // If viewing is enabled at all, you can define whether viewing notes on non-thumbnail images is
    // switched on. Logged-in users can augment this by disabling viewing notes on non-thumbnails
    // on a per-namespace basis using the global variable ImageAnnotator_no_images.
    generalImagesEnabled : function ()
    {
      return true;
    },

    // If thumbs or general images are enabled, you can define whether this shall apply only to local
    // images (return false) or also to images that reside at the shared repository (the Commons). In
    // the 'File:' namespace, displaying notes on shared images is always enabled. (Provided viewing
    // notes is enabled at all there. If you've disabled viewing notes in all namespaces including
    // the 'File:' namespace for non-logged-in users, they won't see notes on images from the Commons
    // either, even if you enable it here.)
    sharedImagesEnabled : function ()
    {
      return true;
    },

    // If thumbs or general images are enabled, you can define here whether you want to allow the
    // script to  display the notes or just a little indicator (an icon in the upper left--or right
    // on rtl wikis--corner of the image). The parameters given are
    //   name         string
    //     the name of the image, starting with "File:"
    //   is_local     boolean
    //     true if the image is local, false if it is from the shared repository
    //   thumb        object {width: integer, height: integer}
    //     Size of the displayed image in the article, in pixels
    //   full_img     object {width: integer, height: integer}
    //     Size of the full image as uploaded, in pixels
    //   nof_notes    integer 
    //     Number of notes on the image
    //   is_thumbnail boolean
    //     true if the image is a thumbnail, false otherwise
    inlineImageUsesIndicator : function (name, is_local, thumb, full_img, nof_notes, is_thumbnail)
    {
      // Of course you could also use wgNamespace or any other of the wg-globals here.
      return    ((   thumb.width < 200 && thumb.height < 200
                  && (thumb.width < full_img.width || thumb.height < full_img.height)
                 )
                  ? nof_notes > 10 : false
                );
      // This default displays only an indicator icon for small images that are scaled down, but
      // that have many notes
    },

    // If notes are displayed on an image included in an article, ImageAnnotator normally adds a
    // caption indicating the presence of notes. If you want to suppress this for all images included
    // in articles, return false. To suppress the caption only for thumbnails, but not for otherwise
    // included images, return !is_thumbnail. To suppress the caption for all images but thumbnails,
    // return is_thumbnail. The parameters are the same as for the function inlineImageUsesIndicator
    // above.
    displayCaptionInArticles : function (name, is_local, thumb, full_img, nof_notes, is_thumbnail)
    {
      return true;
    },

    // Different wikis may have different image setups. For the Wikimedia projects, the image
    // servers are set up to generate missing thumbnails on the fly, so we can just construct
    // a valid thumbnail url to get a thumbnail, even if there isn't one of that size yet.
    // Return true if your wiki has a similar setup. Otherwise, return false.
    thumbnailsGeneratedAutomatically : function ()
    {
      return true;
    },

    // Determine whether an image is locally stored or comes from a central repository. For wikis
    // using the Commons as their central repository, this should not need changing.
    imageIsFromSharedRepository : function (img_url)
    {
      return mw.config.get('wgServer').indexOf ('/commons') < 0 && img_url.indexOf ('/commons') >= 0;
    },

    // Return the URL of the API at the shared file repository. Again, for wikis using the Commons
    // as their central repository, this should not need changing. If your wiki is accessible through
    // https, it's a good idea to also make the shared repository accessible through https and return
    // that secure URL here to avoid warnings about accessing a non-secure site from a secure site.
    sharedRepositoryAPI : function ()
    {
      return '//commons.wikimedia.org/w/api.php';
    },

    // Default coloring. Each note's rectangle has an outer and an inner border.
    outer_border  : '#666666', // Gray
    inner_border  : 'yellow',
    active_border : '#FFA500', // Orange, for highlighting the rectangle of the active note
    new_border    : 'red',     // For drawing rectangles

    // Default threshold for activating the zoom (can be overridden by users).
    zoom_threshold : 8.0,

    UI : {
      defaultLanguage : mw.config.get('wgContentLanguage'), // Don't change this!

      // Translate the texts below into the wgContentLanguage of your wiki. These are used as
      // fallbacks if the localized UI cannot be loaded from the server.
      defaults: {
         wpImageAnnotatorDelete        : 'Löschen'
        ,wpImageAnnotatorEdit          : 'Bearbeiten'
        ,wpImageAnnotatorSave          : 'Speichern'
        ,wpImageAnnotatorCancel        : 'Abbrechen'
        ,wpImageAnnotatorPreview       : 'Vorschau'
        ,wpImageAnnotatorRevert        : 'Zurücksetzen'
        ,wpTranslate                   : 'übersetzen'
        ,wpImageAnnotatorAddButtonText : 'Notiz hinzufügen'
        ,wpImageAnnotatorAddSummary    :
          'Bildnotiz hinzugefügt$1'
        ,wpImageAnnotatorChangeSummary :
          'Bildnotiz geändert$1'
        ,wpImageAnnotatorRemoveSummary :
          'Bildnotiz entfernt$1'
        ,wpImageAnnotatorHasNotesMsg   :
           'Diese Datei ist annotiert. Bewege den Mauszeiger über das Bild oben, um die Notizen zu sehen.'
        ,wpImageAnnotatorEditNotesMsg  :
           '<span>\xa0Die Notizen können auf der Seite <a href="#">x</a> bearbeitet werden.</span>'
        ,wpImageAnnotatorDrawRectMsg   :
           'Zeichne ein Rechteck auf das obige Bild (linken Mausknopf drücken, ziehen, loslassen).'
        ,wpImageAnnotatorEditorLabel   :
           '<span>Text der Notiz (darf '
         + '<a href="//meta.wikimedia.org/wiki/Help:Reference_card">Wiki markup</a> beinhalten)</span>'
        ,wpImageAnnotatorSaveError  :
           '<span><span style="color:red;">'
         + 'Die Notiz konnte nicht gespeichert werden (Bearbeitungskonflikt oder anderes Problem).'
         + '</span> '
         + 'Kopiere bitte den Text im Textfeld und füge ihn von Hand ein, indem Du '
         + '<a href="'
         + mw.config.get('wgArticlePath').replace ('$1', encodeURI (mw.config.get('wgPageName')))
         + '?action=edit">diese Seite bearbeitest</a>.</span>'
        ,wpImageAnnotatorCopyright :
           '<small>Die Notiz wird mehrfach-lizenziert als '
         + '<a href="http://creativecommons.org/licenses/by-sa/3.0/">CC-BY-SA-3.0</a> und '
         + '<a href="http://www.gnu.org/copyleft/fdl.html">GFDL</a>, Versionen 1.2, 1.3 oder '
         + 'jede höhere Version. Siehe die '
         + '<a href="//wikimediafoundation.org/wiki/Nutzungsbedingungen">Nutzungsbedingungen</a> '
         + 'für mehr Informationen.</small>'
        ,wpImageAnnotatorDeleteReason :
           'Warum soll diese Notiz entfernt werden?'
        ,wpImageAnnotatorHelp          : 
           '<span><a href="//de.wikiversity.org/wiki/Hilfe:Bildnotizen" '
         + 'title="Hilfe">Hilfe</a></span>'
        // The following image should be a GIF or an 8bit indexed PNG with transparent background,
        // to make sure that even IE6 displays the transparency correctly. A normal 32bit PNG might
        // display a transparent background as white on IE6.
        ,wpImageAnnotatorIndicatorIcon :
           '<span>'
         + '<img src="//upload.wikimedia.org/wikipedia/commons/8/8a/Gtk-dialog-info-14px.png" '
         + 'width="14" height="14" title="Diese Datei ist annotiert" />'
         + '</span>'
        ,wpImageAnnotatorCannotEditMsg :
           '<span>Bildnotizen können nur bearbeitet werden, wenn Dein Browser das Objekt '
         + '<a href="//de.wikipedia.org/wiki/XMLHttpRequest">XMLHttpRequest</a> '
         + 'kennt. Dein Browser hat dieses Objekt nicht oder erlaubt keinen Zugriff darauf '
         + '(im Internet Explorer kann es sich in einer ausgeschalteten ActiveX-Komponente befinden), '
         + 'und somit kannst Du Bildnotizen leider nicht bearbeiten.</span>'
      }
    }

  }; // End site-wide config.

  // DO NOT CHANGE ANYTHING BELOW THIS LINE
 
  // Start of ImageAnnotator
  if (config.viewingEnabled ()) {
    $(document).ready( function () {ImageAnnotator.install (config);});
  }
  
})();