Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Esri/map-gallery-template-js

This Public Gallery template is designed for anyone who wants to showcase their ArcGIS Online maps, layers, and mobile apps in a dynamic web gallery.
https://github.com/Esri/map-gallery-template-js

arcgis-api arcgis-online configurable-apps gallery-template javascript maps-gallery web-application

Last synced: 3 months ago
JSON representation

This Public Gallery template is designed for anyone who wants to showcase their ArcGIS Online maps, layers, and mobile apps in a dynamic web gallery.

Awesome Lists containing this project

README 

        
# map-gallery-template-js



This PublicGallery template is designed for anyone who wants to showcase their ArcGIS Online maps, layers, and mobile apps in a dynamic gallery. [more info](http://www.arcgis.com/home/item.html?id=34505d89a3b34be09b65b98938974390).



[View it live](http://www.arcgis.com/apps/PublicGallery/index.html)



![App](https://raw.github.com/Esri/map-gallery-template-js/master/Resources/item.png)



## Features

The Public Maps Gallery (PMG) template is designed for anyone who wants to showcase their ArcGIS Online maps, layers, and mobile apps in a dynamic web gallery. The template allows you to control the content that fills the gallery using tools available in your ArcGIS Online account. This means that once you deploy a gallery, keeping gallery content up-to-date is as simple as sharing or un-sharing items in your ArcGIS Online group.

The PMG template is also easily configurable. A complete list of features and enhancements is included with the template as is a quick start guide.



## Instructions



1. Download and unzip the .zip file or clone the repo.

2. Web-enable the directory.

3. Access the .html page.

4. See the readme.html page for configuration options.



[New to Github? Get started here.](https://github.com/)



## Deploying



1. To deploy this application, download the template from Portal/ArcGIS Online and unzip it.

2. 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:////index.html`

3. Change the sharing host, found in options.js inside the config folder for the application, 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:  `"sharingurl": "https://" + “.maps.arcgis.com`

  - Portal Example where `arcgis` is the name of the Web Adaptor: `"sharingurl": "https://" + "webadaptor.domain.com/arcgis"`

4. 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 `"https://js.arcgis.com/3.22"` and replace this portion of the reference with the url to your local install.

  - For example: `"https://webadaptor.domain.com/arcgis/jsapi/jsapi"` where `arcgis` is the name of your Web Adaptor.

5. 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](https://developers.arcgis.com/javascript/jshelp/ags_proxy.html). 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](https://developers.arcgis.com/).



 [New to Github? Get started here.](https://github.com/)



## Requirements



* Notepad or HTML editor

* A little background with Javascript

* Experience with the [ArcGIS Javascript API](http://www.esri.com/) would help.



## Resources



* [ArcGIS for JavaScript API Resource Center](http://help.arcgis.com/en/webapi/javascript/arcgis/index.html)

* [ArcGIS Blog](http://blogs.esri.com/esri/arcgis/)

* [twitter@esri](http://twitter.com/esri)



## Issues



Find 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](https://raw.github.com/Esri/map-gallery-template-js/master/license.txt) file.