Improve My City for WordPress is a platform for managing local issues; from reporting, to administration and analysis.
It is an integrated solution aimed to local governments seeking collaboration with their citizens, freely available as open source.
Collecting issues via web or mobile.
Reported via web or mobile
By allowing citizens to report issues from their home using the web version, or while on the street using the mobile app (iOS & Android).
Easily composed but descriptive
By asking citizens to provide only the information necessary to locate and resolve the issue, such as title, description, location and category.
By offering a map to facilitate citizens in determining the exact location of their issue.
By allowing to attach an image on the spot for describing the issue.
Categorized based on their nature
By urging citizens to select one of the pre-specified categories reflecting the municipality departments.
Commented and voted
By offering the mechanisms to post comments or vote for issues that have been submitted by other citizens.
Easy to use administration platform.
Issues are presented on the city map, as an ordered list but also in a single-issue page displaying the full set of submitted details.
Assign one or more officers per category and split the administration effort across the municipality departments.
Track pending issues
Issues are automatically routed not only to the appropriate department but also to the inbox of the responsible officer.
Monitor progress and update citizens
Resolve issues and inform citizens by email or through a progress indication bar (Open -> Acknowledged -> Closed).
Provide direct feedback
Provide written feedback to the citizens giving non-standard explanations for each specific case.
 Set IMC Main Page
The Improve My City Main Page (IMC-Improve My City Main Page) is located on Pages > IMC Improve My City Main Page.
After activating the plugin, a page called «IMC – Improve My City Main Page» is automatically created. This is the core page of the plugin, where all the issues will be presented. You can add it on a menu, or assign it as you front page. If you ever delete this page or any page that is created by the Improve My City plugin you can bring them back by disabling and enabling the plugin again.
- [1.1] Add Improve My City Main Page to your main menu
- Visit Appearance > Menus
- Choose an existing menu or create a new one.
- Search and Add to Menu the «IMC – Improve My City Main page» from the Pages section.
- Choose a location for your menu at Theme locations and save it.
- [1.2] Set Improve My City Main Page as your site’s Front page
If you want to use the Improve My City Main Page as your front page, go to Settings > Reading and set «Front page displays» to «A static page». From the dropdown menu, select the «IMC – Improve My City Main Page».
 Issues & Categories
- [2.1] Before creating your first Issue
Each issue that is submitted to the «Improve My City» platform is assigned a Status and a Category. Statuses denote the progress of an issue. You can have as many statuses as you want, although it is best to limit the number of statuses to 6. You can have as many Categories as you like.
Before using the plugin to report issues, there has to be at least one Status and one Category set, so the plugin can function as intended.
In the following sections, it is described how to manage the Statuses & Categories.
- [2.2] Manage Statuses
To access the Status manager navigate to Improve My City menu > Issue Statuses.
On the left hand side of this screen you can add a new status by providing the necessary information:
- Name: The Status name that will be shown everywhere in the application.
- Slug: The unique identifier of the Status. It usually is the status name in lowercase without special characters and spaces.
- Description: A short description about the status that is usually used internally to convey information between administrators.
- Color: A unique color that best represents the status. Use the color picker to select from a predefined color or set your own.
Then click on the Add new Status button to save it.
You can also edit an existing Status.
On the right hand side of this screen resides the Status table that lists all of your created statuses. The chronological order that they are created, define the order of each step (as seen in the order field).
For example the first status that you create, is also an issue’s first (initial) status (the one with the smallest order number). The second one is the status after the initial, and so on.
There is a soon to be implemented ordering mechanism to enable setting the ordering manually.
- [2.3] Manage Categories
To access the Category manager navigate to Improve My City menu > Issue Categories
On the left hand side of this screen you can add a new category by providing the necessary information:
- Name: The Category name that will be shown everywhere in the application.
- Slug: The unique identifier of the Category. It usually is the category name in lowercase without special characters and spaces.
- Parent: Use this dropdown if you want to make this Category a sub-Category; you have to select the sub-category’s parent category. «Improve My City» can only support depth of one level.
- Description: A short description about the category that is usually used internally to convey information between administrators.
- E-mail Notifications: The e-mail address that will receive all notifications about any changes. You can use more than one if you like, by separating them with a comma. By leaving it blank, it means that all the notifications for this category will be sent to the website’s admin mail (WordPress admin).
- Category Image: Select an icon that will represent this category. Icons should have at least 100×100 pixels size and background transparency.
Then click on the Add new Category button to save it.
You can also edit an existing Category.
On the right hand side of this screen resides the Categories table that lists all of your created categories.
 Issue Reporting
In the following section, the default roadmap on how to report an issue is described, both from the frontend and from the administrator panel.
- [3.1] Report an issue (Citizens)
To report a new issue as a citizen:
1. Visit Improve My City Main Page on your website.
2. Click on Report an issue link at the top right of your screen
3. There are five pieces of information associated with each new Issue that you need to fill in.
Title: Add a short title for the issue
Category: Select an appropriate category from the dropdown option.
Description: Write a thorough description of the issue.
Address: Add the specific address of issue’s location. By dragging the pin icon on the map, the Address field is populated automatically. You can also start typing and the auto-complete feature will suggest an address based on your location. The Locate button is used to make sure that the address entered is correct.
Photo: (optional) Attach a photo of the issue. Photo size must be less than 2MB.
- [3.2] Report an issue (Administrators)
To report an issue as administrator:
1. Visit Improve My City > Add New at your dashboard
2. There are six pieces of information associated with each new Issue that you need to fill in.
Title: Add a short title for the issue [4.2.1]
Description: Write a thorough description of the issue [4.2.2]
Address: Add the specific address of issue’s location. By dragging the pin icon on the map, the Address field is populated automatically. You can also start typing and the auto-complete feature will suggest an address based on your location. The Locate address button is used to make sure that the address entered is correct. [4.2.3]
Category: Select an appropriate category from the dropdown option. [4.2.4]
Status: Select an appropriate status from the dropdown option. [4.2.5]
Photo: (optional) Attach a photo using the Featured Image field. [4.2.6]
You can also enable/disable comments for this issue by checking/unchecking the «Allow Comments» checkbox.
 Improve My City Settings
The Improve My City Settings are located on Settings > IMC Settings, spanning 3 tabs.
- [4.1] Settings regarding Google Map
In this tab resides all the configuration options about the Map functionality of the plugin.
- Google Maps API KEY: Add your API Key to authenticate requests about your Google Maps. For more information on getting an API Key, see the Google Developers website.[5.1.1]
- Initial Address: Add specific address that every map in IMC will have as default. By dragging the pin icon on the map, the Initial Address field is populated automatically.[5.1.2]
- Initial Latitude: Add a specific latitude value that every map in IMC will have as default.[5.1.3]
- Initial Longitude: Add a specific longitude value that every map in IMC will have as default.[5.1.4]
Note: The 5.1.3 and 5.1.4 values are populated automatically when you set an Initial Address on 5.1.2.
- Initial Map Zoom: Set the default zoom of the map. Available values range between 0 and 20.[5.1.5]
- Map Language: Change the in-map language as well as the directions output language. See supported list of languages.[5.1.6]
- Map Region: Change map region to apply bias for IMC behavior towards your Region. See Unicode region subtag identifiers.[5.1.7]
- Allow zooming with mouse scroll wheel: Choose if you want to enable zooming on the map, using the mouse scroll wheel.[5.1.8]
- Clustering markers: The map clustering functionality will be available and thoroughly documented at a later time.[5.1.9]
- Boundaries: Insert a GeoJSON object, extracted from the OpenStreetMaps page to display your city’s boundaries and allow reporting only inside these limits.[5.1.10]
- [4.2] Settings regarding Notifications
In this tab the administrator can enable or disable the dispatch of notification e-mails for a range of the plugin actions.
- On new issue to user: Send an e-mail notification to Citizen, immediately after reporting an issue.[5.2.1]
- On new issue to admins: Send an e-mail notification to Admins, immediately after an issue reported on their Category (See [3.2]).[5.2.2]
- On change category to user: Send an e-mail notification to Citizen when his issue has changed category.[5.2.3]
- On change category to admins: Send an e-mail notification to Admins, immediately after an issue has moved to their category (See [3.2]).[5.2.4]
- On change status to user: Send an e-mail notification to Citizen when his issue has changed status.[5.2.5]
- On change status to admins: Send an e-mail notification to Admins (See [3.2]), immediately after an issue has changed status.[5.2.6]
- On new comment to admins: Send an e-mail notification to Admin immediately after a comment is published.[5.2.7]
- [4.3] General Settings
In this section the administrator can set whether new issues will be published immediately, or will be moderated at first.
- Moderate new Issues: Set if you want to moderate new issues. This means that when a citizen reports an issue, it is saved as a draft, so an administrator can check the issues information first and then publish it. [5.3.1]
 Roles and Capabilities
- [5.1] Roles of Improve My City
A Role defines a set of tasks that an assigned user can perform. Improve My City plugin uses three different roles for giving the ability to control what users can and cannot do within the platform.
- Administrator: (WordPress default role) A user that has access to everything in your site and the entirety of the Improve My City plugin.
- Department Admin: (Custom role) A user that has access to the entirety of the Improve My City plugin but not on the rest of the website.
- Subscriber: (WordPress default role) This role is the default for citizens. It allows reporting, editing and browsing issues on the front end, while it denies access to the administration platform.
- [5.2] Add New User as Department Admin
You can create a new Department Admin user by visiting Users > Add New and selecting «Department Admin» as a Role option.
 Important Notes
- [6.1] Allow citizens to report issues
In order to allow citizens to report issues, you need to enable registration to your website.
1. Visit Settings > General
2. Check Anyone can register at Membership option
3. Select Subscriber at New User Default Role option
4. Provide Login & Register Links at your site
Install the plugin through the WordPress plugins screen directly or upload the plugin files to the
Activate the plugin through the ‘Plugins’ screen in WordPress.
Use the Settings->IMC Settings screen to configure the plugin.
Is Improve My City free?
Yes! All the functionality offered by the plugin is free, as long as you have a working WordPress installation.
Can I translate Improve My City in my language?
Yes you can! As of version 1.3.1 the community translation system has been activated.
Go to https://translate.wordpress.org/projects/wp-plugins/improve-my-city
Select your language and start translating!
How can I customize the permalink structure slug?
It can be customized from the IMC Settings.
How to insert Boundaries?
You can now search for a city or a municipality from settings. Choose one from the results and preview the boundaries on the map before saving changes.
Alternatively you can set your own boundaries usign the following format:
Is there a way to enable everyone to submit an issue, without having to sign in?
Unfortunately no, since this would be against the rationale of ‘Improve My City’. Every citizen must have his own account, in order to vote, comment and follow the progress of the submitted issues. This also ensures the transparency between citizens and municipality.
Step 1. Create a Facebook or Google app and note the provided information.
Step 2. Access the config.php file that is located in plugin_root_folder/hybridauth/ and change the base_url, and the provider information to yours.
Contributors & Developers
“Improve My City” is open source software. The following people have contributed to this plugin.Contributors
“Improve My City” has been translated into 8 locales. Thank you to the translators for their contributions.
Translate “Improve My City” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Release Date – 15/01/2022
Fully compatible with WordPress 5.8.3
Fully compatible with PHP version 8.1.1
Release Date – 15/07/2019
Fully compatible with WordPress 5.2
Gutenberg Editor Migration: Removed the Featured Image panel, and then added the Issue Image IMC panel in the backend editor.
Added a link to scroll directly to issue comments (if any) from list/grid view of all issues.
Release Date – 15/02/2019
Solved a localization dependency error, that resulted on the category icon selector to not work (backend).
Release Date – 02/10/2018
Fixed an issue for extra small screens, where the add new issue button was inaccessible.
Release Date – 12/07/2018
Fully compatible with WordPress 4.9.6.
Added Category Icon to issue overview in the backend and fixed a bug with the status color.
Fixed an SQL call that was sometimes crashing the filtering functionality.
Under the hood fix: Changed a bit how the dates when changing the status or category of an issue are calculated in the admin panel, to avoid the input of false data.
Fixed a status/category change date bug
Fixed overlapping class overlay text for google maps. Now the text appears centered.
Code tweaks all around
Release Date – 29/06/2018
New Feature: Added Auto Geolocation through browser GPS API. Note – Working only on SSL enabled websites (https).
Updated Google Maps to use ctrl + scrollwheel to zoom in/out.
Fixed a bug where a new status created on the backend wouldn’t get the right ordering value.
Many thanks to user flachzange for his help.
Fixed a bug where when creating a new post from the backend, it would sometimes fail due to wrong edit page capabilities.
Updated HybridAuth to version 2.11.0
Squashed many bugs.
Minor code improvements.
Release Date – 24/01/2018
Now fully compatible with PHP 7.2.0 and WordPress 4.9.2.
Removed deprecated function screen_icon().
Fixed warning about Status Ordering parameter (backend) on PHP 7.2.0.
Fixed bug when Taxonomy Category is empty at meta box (backend).
Fixed bug about $tag parameter variable type error (mail & color at backend).
Fixed bug at color picker warning (specified default value).
Fixed warning at issue columns (backend).
Release Date – 28/11/2017
Fully compatible with WordPress 4.9
Upped PHP version requirement: 5.2.4+ -> 5.4.0+
Tested and fully compatible with PHP 7.0.
Change in how various scripts are loaded, to avoid rare bugs and align with WordPress best practices.
Updated HybridAuth to version 2.9.6 (Facebook login error persists. It’s going to be fixed in an upcoming version).
Theme fix: In the issues list view, odd & even list items have now different background color to differentiate between successive elements.
Bugfix: Disabling submit button after an issue has been submitted or edited to avoid submitting multiple times.
Bugfix: Fixed an issue where the language or encoding of an issue image filename, was interfering with the upload process.
Improvement: Addressed all php warnings incited by the plugin.
Theme fixes / improved web components abstraction for better theme integration.
Many bug fixes and theme & code improvements.
Release Date – 16/03/2017
Bugfix: Fixed bug on the backend when editing a category or a step and the edit category icon and color respectively were broken.
Bugfix: Detailed issue view: Added the correct issue id variable. The variable was implied, in rare cases breaking functionality.
Various bug fixes and code improvements.
Release Date – 15/03/2017
Changed text domain for the translations to be accessible to community.
Release Date – 15/03/2017
Fully compatible with WordPress 4.7
The code about adding our IMC page templates, has been updated to work on WordPress 4.7+
Major bugfix: In WP Installations 4.7+ the issue status was not saved correctly and as a result was breaking functionality.
It has now been fixed. If you have been affected by this issue, just change the status of all the affected issues to make them work again as intended.
In single issue page, the edit button was shown inconsistently. It has been fixed.
Fixed a styling bug on the backend, where in screens under 782 width, the title in the admin view for issues was obstructed.
Added a PHP version check message.
Release Date – 07/11/2016
Fully compatible with WordPress 4.6.
Implemented a new boundaries check on the backend. You can now search for a city or a municipality, choose one from the results and preview the boundaries on the map before saving changes.
Alternatively you can set your own boundaries usign the following format:
Settings option added, about setting the default issues layout (grid or list view).
Some more options on settings have been added.
Critical bug about email notifications on comments resolved.
Mail title bug resolved.
Many layout & styling fixes on the frontend & backend.
Cleaned up some JS scripts & unneeded assets.
New translation strings & fixes (please send us the new ones to upload in next incremental update).
Added arabic translations.
Updated social login authentication plugin to latest version.
Release Date – 13/09/2016
When editing an issue from the backend, You couldn’t change the date. It has been fixed.
Added some missing translations too.
Please update your po/mo files.
Release Date – 26/08/2016
Fixed some issues with translations.
Please update your po/mo files.
Release Date – 24/08/2016
Translations are now working properly. Just update your language through poedit.
-> Greek translation has been updated.
-> English .mo template file has been updated.
(Please update if you have been working on translating the plugin to another language)
Squashed a lot of bugs!
Release Date – 08/07/2016
- NOTICE: Major changes in this release. Please read below before updating!
This update to the Improve My City plugin adds new functionality, changes the initial structure of the plugin and paves the way for the upcoming release of the Improve My City WordPress API.
It is advised to delete your current plugin and do a clean installation of the new one, as some functionality will not be working with the update.
Make sure you delete all the Improve My City posts, categories and statuses.
If you have been already using the plugin and you have a sufficient userbase / issue load, please feel free to contact us so as to help you migrate your installation to the new one.
- New Features:
Social Media login (using Facebook or Google).
Custom slug for issues page.
Api section in settings, regarding the upcoming Improve My City WordPress API functionality.
Many fixes and tweaks.
Release Date – 13/05/2016
- Bugfix: Fixed an issue with the comments form, when using intrusive themes.
Release Date – 07/04/2016
- First stable release.