forked from apppresser/AppPresser
/
readme.txt
217 lines (149 loc) · 10.1 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
=== AppPresser - Mobile App Framework ===
Contributors: apppresser, webdevstudios, williamsba1, scottopolis, jtsternberg, Messenlehner, LisaSabinWilson, tw2113
Donate link: http://apppresser.com/
Tags: mobile, app, ios, android, application, phonegap, iphone app, android app, mobile app, native app, wordpress mobile, ipad app, iOS app
Requires at least: 3.5
Tested up to: 3.9.1
Stable tag: 1.1.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Build native iOS and Android mobile apps with the AppPresser framework.
== Description ==
AppPresser is the first native mobile app development framework for WordPress.
[AppPresser](http://apppresser.com/ "AppPresser mobile apps with WordPress") allows you to use a WordPress site as an app, including access to device features such as the camera, contacts, and more. You can create your app completely in WordPress, using themes, plugins, and all the stuff you already know.
Developers can use this plugin to make custom apps, or custom extensions for AppPresser. If you are not a developer, please see our website for more information about creating an app with WordPress.
This plugin is not an app-creator in itself, it serves as the core for all app development with AppPresser.
[youtube http://www.youtube.com/watch?v=i8Deew6pif4]
Want to contribute to AppPresser? Awesome! Visit our [GitHub site for the project](https://github.com/WebDevStudios/AppPresser "AppPresser on GitHub").
### What this plugin does:
* Integrates Phonegap with WordPress, which exposes the [Phonegap API](http://docs.phonegap.com/en/3.2.0/index.html "Phonegap docs")
* Allows you to use javascript (using the Phonegap API) to use native device features
* Allows you to use other AppPresser plugins and themes to create an app
* Adds a settings page with app-only homepage, menus, and theme settings
#### What this plugin DOES NOT do:
* It does not automatically create an app for you, or give you a WYSIWYG app creator
* It does not change your site aesthetically
* It does not allow you to test any app features in the browser, (you need Xcode or Eclipse for that)
* It does not build the app for you
#### How do I use it?
* Install and activate the plugin
* Add AppPresser themes or extensions to create your app
* Build your app yourself with Phonegap, or with our build service
* Distribute to the iOS/Android app stores
== Installation ==
1. Upload AppPresser to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to AppPresser settings page to configure
After installing, optionally add AppPresser theme/extensions, or use the [Phonegap API](http://docs.phonegap.com/en/3.2.0/index.html "Phonegap docs") to create custom apps.
== Frequently Asked Questions ==
Please see our [FAQ page](http://apppresser.com/faq/ "FAQ") for the newest information.
= I activated the plugin and nothing happened. =
This plugin does not do a whole lot by itself, you need to use our extensions and themes to actually create the app.
This plugin is the core development framework for developers to create their own apps or extensions, it is not meant to be an end in itself.
= Do I need coding skills to use AppPresser? =
Using only this plugin by itself, you will need to add your own code to create the app.
If you use one of our pre-made app bundles, like the ecommerce app, you are not required to code anything.
= How do I test the app features like camera, contacts, etc.? =
Native device features only work on native devices, so they won’t work in your browser.
To test this, you need to setup a local testing environment with Xcode (iOS) or Eclipse (Android). You then need a Phonegap project that you can load into your emulator. To test on a real iOS device, you need an Apple developer account and a provisioned device. (Android does not have the same requirements)
Please see our website for a tutorial.
= Can I make any type of app I want? =
Technically you can do anything with an AppPresser app that you can do with Phonegap. That means if you are handy with javascript, the sky is the limit!
== Screenshots ==
1. AppPresser admin options page.
== Changelog ==
= 1.1.3 =
* Roll back script optimization to fix push notifications and other bugs
= 1.1.2 =
* Fix for splashscreen hide
= 1.1.1 =
* Enhancement: optimize cordova scripts to only load when needed
* Moved app menu settings to theme customizer exclusively
* Hide app splashscreen on load
* Misc bug fixes
= 1.1.0 =
* Fixed annoyance of settings page not returning to the tab you were on when you clicked 'save.'
* Enhancement: New filter, "apppresser_sanitize_setting_$key" for registering your own sanitization callback to override AppPresser's.
* Enhancement: New filter, "apppresser_field_override_$type" for registering your own field type view callback to override AppPresser's.
* Enhancement: Added [CMB](https://github.com/WebDevStudios/Custom-Metaboxes-and-Fields-for-WordPress). Settings API will be re-worked in next versions to use CMB.
= 1.0.9 =
* Bug Fix: App-theme settings were not getting displayed if the theme was not active (despite being set as the App-only theme)
= 1.0.8 =
* Bug Fix: Theme\_mod settings would get the non-theme_mod setting warning asterisk if no value had been saved to them yet.
* Bug Fix: If the "Load AppPresser for Admins Only" setting was not checked, the theme customizer would try to activate the app theme from the customizer.
= 1.0.7 =
* Enable theme customizer for the App-only theme while theme is not active. There is now a link to customize the theme below the select dropdown.
= 1.0.6 =
* Enhancement: New filter `apppresser_theme_settings_file` that allows you to set the location of your theme's AppPresser settings registration (so your settings show when the theme is not active). Will fallback to looking for `appp-settings.php` file in the theme root.
* Enhancement: New filter `apppresser_notifications`, allows other plugins/themes to add their own notification count.
= 1.0.5 =
* Enhancement/Bug Fix: Don't delete license keys and other options if a particular plugin is deactivated at the time of saving.
* Enhancement/Bug Fix: AppPresser "App only theme" option now works with child themes.
* Enhancement: Add a `apppresser_tab_top_$tab` hook to match the `apppresser_tab_bottom_$tab` hook.
= 1.0.4.1 =
* Remove "App only theme?" front-end error.
= 1.0.4 =
* Extensions submenu highlighting available for AppPresser add-ons.
* Addressed some pre-PHP 5.3 notices.
* Bug Fix: White-screen on the front end if selecting a theme in the "App only theme?" setting that does not support AppPresser. An error will now be shown.
* Improvement: `appp_get_setting()` now accepts a fallback option like `get_option()`.
= 1.0.3 =
* Bug Fix: `plugins_loaded` firing too early causing conflicts with other plugins.
* Improvement: Check child theme for `app-settings.php` file as well as parent theme.
* Improvement: Added method for loading AppPresser theme despite aggresively cached web hosts.
= 1.0.2 =
* Bug Fix: Conflict causing other themes to appear to need an update.
= 1.0.1 =
* Bug Fixes
* Add theme updater and updater API
* Better styling for "MP6"
= 1.0.0 =
* Release into the wild!
== Upgrade Notice ==
= 1.1.3 =
* Roll back script optimization to fix push notifications and other bugs
= 1.1.2 =
* Fix for splashscreen hide
= 1.1.1 =
* Enhancement: optimize cordova scripts to only load when needed
* Moved app menu settings to theme customizer exclusively
* Hide app splashscreen on load
* Misc bug fixes
= 1.1.0 =
* Fixed annoyance of settings page not returning to the tab you were on when you clicked 'save.'
* Enhancement: New filter, "apppresser_sanitize_setting_$key" for registering your own sanitization callback to override AppPresser's.
* Enhancement: New filter, "apppresser_field_override_$type" for registering your own field type view callback to override AppPresser's.
* Enhancement: Added [CMB](https://github.com/WebDevStudios/Custom-Metaboxes-and-Fields-for-WordPress). Settings API will be re-worked in next versions to use CMB.
= 1.0.9 =
* Bug Fix: App-theme settings were not getting displayed if the theme was not active (despite being set as the App-only theme)
= 1.0.8 =
* Bug Fix: Theme\_mod settings would get the non-theme_mod setting warning asterisk if no value had been saved to them yet.
* Bug Fix: If the "Load AppPresser for Admins Only" setting was not checked, the theme customizer would try to activate the app theme from the customizer.
= 1.0.7 =
* Enable theme customizer for the App-only theme while theme is not active. There is now a link to customize the theme below the select dropdown.
= 1.0.6 =
* Enhancement: New filter `apppresser_theme_settings_file` that allows you to set the location of your theme's AppPresser settings registration (so your settings show when the theme is not active). Will fallback to looking for `appp-settings.php` file in the theme root.
* Enhancement: New filter `apppresser_notifications`, allows other plugins/themes to add their own notification count.
= 1.0.5 =
* Enhancement/Bug Fix: Don't delete license keys and other options if a particular plugin is deactivated at the time of saving.
* Enhancement/Bug Fix: AppPresser "App only theme" option now works with child themes.
* Enhancement: Add a `apppresser_tab_top_$tab` hook to match the `apppresser_tab_bottom_$tab` hook.
= 1.0.4.1 =
* Remove "App only theme?" front-end error.
= 1.0.4 =
* Extensions submenu highlighting available for AppPresser add-ons.
* Addressed some pre-PHP 5.3 notices.
* Bug Fix: White-screen on the front end if selecting a theme in the "App only theme?" setting that does not support AppPresser. An error will now be shown.
* Improvement: `appp_get_setting()` now accepts a fallback option like `get_option()`.
= 1.0.3 =
* Bug Fix: `plugins_loaded` firing too early causing conflicts with other plugins.
* Improvement: Check child theme for `app-settings.php` file as well as parent theme.
* Improvement: Added method for loading AppPresser theme despite aggresively cached web hosts.
= 1.0.2 =
* Bug Fix: Conflict causing other themes to appear to need an update.
= 1.0.1 =
* Bug Fixes
* Add theme updater and updater API
* Better styling for "MP6"
= 1.0.0 =
* Release into the wild!