basic-viewer-template
basic-viewer-template copied to clipboard
Classic Viewer is a configurable application template that enables you to display an ArcGIS web map using a variety of tools.
ArcGIS Configurable Apps will be retired in 2025. The ArcGIS Configurable Apps source code repro is deprecated and will not receive further updates. In addition, this repository will be removed in October 2025, along with the October 2025 ArcGIS Online update.
DEPRECATED: Classic Viewer
Note: An updated version of this application has been created that contains much of the funcationality of this template but with an updated look and feel. We will continue to fix bugs in this version but all new development efforts will be in the new application. Visit the new template repo for more details.
Classic Viewer is a configurable application template that enables you to display an ArcGIS web map using a variety of tools.
#Features The template can be configured using the following options:
- Map: Choose the web map used in your application.
- Color Scheme: Choose between five color schemes for the application (Blue, Gray, Green, Orange, Purple).
- Show Title: Choose whether to include an application title.
- Title Text: The application title. The default title is the web map name.
- Logo: Choose a custom logo for your application.
- Overview Map: Display a retractable overview map to add context for panning and zooming.
- Legend: Display a legend for map layers. *
- Details: Display the web map item description. *
- Editor: Allows users to interactively create, modify, or delete features in editable layers. *
- Time Slider: Enables the display of the time slider. *
- Print: Enables printing the map at the current extent. It can be configured to include a legend and supports different layout options.
- Layer List: Enables toggling the visibility of operational layers within the web map. *
- Basemaps: Enables the display of the basemap gallery.
- Bookmarks: Enables the use of web map bookmarks for navigation. *
- Measure: Enables measure tool for interactive area, length, and point measurement.
- Share: Allows users to share the application with others via email, Twitter, or Facebook.
- Search: Displays the Search box to enable navigation to addresses and places.
- Search for locations within current extent: Enable toggling of search within the current map extent only.
*These options will appear in the application when the web map has properties or layers that support them.
Instructions
- Download and unzip the .zip file or clone the repository.
- Web-enable the directory.
- Access the .html page.
- Start writing your template!
New to Github? Get started here.
Deploying
- To deploy this application, download the template from Portal/ArcGIS Online and unzip it.
- Copy the unzipped folder containing the web app template files, such as index.html, to your web server. You can rename the folder to change the URL through which users will access the application. By default the URL to the app will be
http://<Your Web Server>/<app folder name>/index.html
- Change the sharing host, found at line 61 of index.html, to the sharing URL for ArcGIS Online or Portal. For ArcGIS Online users, keep the default value of www.arcgis.com or specify the name of your organization.
- ArcGIS Online Example:
"sharinghost": location.protocol + "//" + “<your organization name>.maps.arcgis.com
- Portal Example where
arcgis
is the name of the Web Adaptor:"sharinghost": location.protocol + "//" + "webadaptor.domain.com/arcgis"
- If you are using Portal or a local install of the ArcGIS API for JavaScript, change all references to the ArcGIS API for JavaScript in index.html to refer to your local copy of the API. Search for the references containing
"//js.arcgis.com/3.13"
and replace this portion of the reference with the url to your local install.
- For example:
"//webadaptor.domain.com/arcgis/jsapi/jsapi"
wherearcgis
is the name of your Web Adaptor.
- Copy a map or group ID from Portal/ArcGIS Online and replace the default web map ID in the application’s index.html page. You can now run the application on your web server or customize the application further.
Note: If your application edits features in a feature service, contains secure services or web maps that aren't shared publicly, or generate requests that exceed 200 characters, you may need to set up and use a proxy page. Common situations where you may exceed the URL length are using complex polygons as input to a task or specifying a spatial reference using well-known text (WKT). For details on installing and configuring a proxy page see Using the proxy. If you do not have an Internet connection, you will need to access and deploy the ArcGIS API for JavaScript documentation from developers.arcgis.com.
For addtional customization options view the wiki.
#Requirements
- Notepad or HTML editor
- Some background with HTML, CSS and JavaScript
- Experience with the ArcGIS API for JavaScript is helpful.
#Resources
#Issues Found a bug or want to request a new feature? Please let us know by submitting an issue.
#Contributing Anyone and everyone is welcome to contribute.
#Licensing
Copyright 2012 Esri
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
A copy of the license is available in the repository's license.txt file.