.. _2.6_Release: GeoMoose 2.6 Release ==================== Mapbook Changes --------------- Frightening as they may be there is a subtle mapbook change: * ``status`` was attributed to the Catalog in versions 2.0-2.4. This was moved to the map-source's ```` entry. There are some academic and implementation reasons for this. * ````'s ```` now MUST be delineated by "." if defining or redefining a sub-member. The following was once valid:: It is no longer, don't do it, you will only hurt yourself. * ``mapserver_url`` and ``mapfile_root`` are not required in the mapbook any longer. * Default sketch color parameters used to be configured like:: red yellow 1 which no longer does anything. Now default sketch colors are configured with:: * Not actually a mapbook change, but previous uses of ```` may not work without modifying your .map files. See also :ref:`layers_all` * ```` changes "/" is no longer allowed in map-source names: E.g. ```` needs to become something like ````. For WMS sources, ```` may be needed where only ```` was required before for imagery layers. * Catalog groups now default to ``expand="true"``, in 2.4 they defaulted to ``expand="false"``. Deprecation Notices ------------------- * The ``ScaleLine`` is no longer honored by configuration. You'll need to include the ``ScaleLine.js`` Extension. * Client-side raster reprojection: This has never worked well and is really only used to create Web Mercator support on servers that don't natively provide it. There are simply better tools for this. Please see TileCache, MapProxy, or configure MapServer as a WMS client. * The "cycle" tool has been removed from the catalog. * Custom tabs are now implemented completely differently. Please see ``extensions/CustomTab.js`` for an example of what the code for a custom tab looks like. The demos are configured to display a custom tab by default. * IE6 compatibility is no longer tested nor promised. Transparent GIFs are being dropped in favor of PNGs. IE6 hates PNGs. * CSS control of Toolbar-Tool labels. Please "enhancements." * The ``help`` attribute of the layers have been deprecated. This was mostly redundant with the ``metadata`` attribute. Enhancements ------------ * New integration with Dojo * New configuration parameter: ``flashy_bits`` will toggle on/off animation effects added to 2.6. * It was once necessary to do some reasonably serious CSS hacking to turn on or off the labels for a particular tool in the toolbar. Now, it's much easier. Simply set the ``show-label`` attribute to ``true`` or ``false`` in the Mapbook. Example:: The default behavior can changed by setting the configuration parameter ``toolbar.show_labels`` to either ``true`` or ``false``. * Drawers now work like popup menus. They now have their own ``title`` and ``icon-class`` attributes. * Setting a custom icon in the toolbar. This is another point of pain that required much CSS hacking. Now, define the icon class in any of your included CSS files and tell the tool to use that class. Example:: * Static-legends are now properly supported. The mapbook syntax is as follows:: ... snip ... /url/to/legend.png ... snip ... Configuration Changes --------------------- There is now a ``local_settings.ini`` file in the ``conf/`` directory. An SVN checkout will not feature this file. It is up to the installer to create. For MS4W installs, simply copy ``ms4w_local_settings.ini`` to ``local_settings.ini``. Also, users should no longer edit ``settings.ini``, it can be considered the default settings. Any setting placed in ``local_settings.ini`` will overwrite the one in ``settings.ini``. .. _layers_all: Why doesn't layers=all work anymore? ------------------------------------ Changing to GeoMOOSE 2.6 breaks the ```` usage in ``mapbook.xml`` and gives me this error:: msWMSLoadGetMapParams(): WMS server error. Invalid layer(s) given in the LAYERS parameter. This is due to changing the default type to WMS rather than MapServer. The same thing can still be achieved, the .map files just need a little revision. This is covered some in this `thread `_ and referenced ticket. For the record, here is what bobb wrote: Johan, I don't think that ``layers=all`` is a valid WMS call parameter . . . A work around is mentioned in here related to GROUPS in the mapfile. http://trac.osgeo.org/mapserver/ticket/1603 -bobb