General Documentation

Have a technical issue? Create a ticket 

Features Documentation

Documentation

Job

With this feature, you will be able to create a list of job offers. Click on in the “Add pages” section, to add the feature to your app: (Please note that the tab “Positions” is available after you have created one company at least) In “General” you can manage general settings for the Job feature:

  • “Display search“: display the search bar on the main page of the feature
  • “Display place icon“: display the logo of the company next to the job offer
  • “Display income“: display the position’s income on the job offer page
  • “Display contact“: you can select which type of contact you want to display on the position page
  • “Default search distance“: The default max distance between the users and the offers displayed on the feature
  • “Distance unit“: Choose between Kilometers or Miles
Companies: In this section you can add the companies which offer positions: Click on + to add a company:
  • “Name“: It’s the name of the company
  • “Description“: It’s the description of your company’s field/projects/objectives/etc…
  • “E-mail“: It’s the mail that will receive all the job applies
  • “Administrators“: It’s a user(s) who can manage the job offers and the company’s info directly from the app.
  • “Display contact“: It’s the same settings from the General tab. “Use global configuration” will use the settings from the General tab.
Positions: In this section you can add the job offers: Complete the position information and choose the company that offer this job from the list of the companies you have created. Categories: In this section you can create categories for the positions offered: Click on + to create a category: The feature in the application The job offers are displayed on the main page of the feature. On the position page, you can see the localisation of the position, contact the company and look at the company’s info. On the company page you can see a description of the company and all the positions offered by this company. Important: if the user has admin access, he will be able to edit the job offer by clicking on on the position page: He can also edit the company info by clicking on and create a job offer by clicking on :



MCommerce

With the Commerce feature you will be able to sell your products from one or several store. Users will be able to pay online via Paypal or Stripe, to pay at your store or at the delivery. Note: Every stores you will create, will have the same catalog, see it like a “franchise”. Let’s go! To add “Commerce” feature in your app, click on in the “Add pages” section: 1. Create Store: Click on + to add a store and fill out your store’s info: Then add your delivery options: You can choose from:

  • “In store”: Your clients will have to come to the store
  • “Carry out”: Your clients will have to come to the store to get the product and then leave the store with the product
  • “Delivery”: You can deliver your goods to your clients
If you choose “Delivery”, some other options are displayed:
  • “Delivery fees”: The cost of the delivery
  • “Free delivery starting from”: If you want the delivery to be free when the order reaches a certain price
  • “The clients calculate the change”: Add a field at the end of the order where the client will specify the type of cash he will use. For example, if he uses a 50$ bill, you will be notified
  • “Delivery radius”: Indicate the area you deliver from your store address, in km
  • “Delivery time”: The average time of delivery, between the order and the start of the delivery, in minutes
  • “Minimum order”: Set the minimum price for a delivery
Then add your payment options. If you choose Paypal, you’ll need to do some mandatory operations in your Paypal account, click here to see how you have to set up your Paypal account to enable it in your app. You can also pay by credit card when you pick up your order / upon delivery or you can directly pay by credit card online. To do that you just have to select the option “credit card (online payment)” and fill out the two sections “Secret Key” and “Publishable key” you obtained on Stripe. If you don’t know these keys, just check out this page to know how to get them. Then, create a Tax for your Store: Save by clicking on "Save" 2. Create catagories for your products: Go to “Catalog” and click on “My categories“: Click on + to add your categories: A first one is automatically created but won’t be shown to users. It’s your root category but once again it will not be shown to users so you can leave it like that. Select it and click on “+” to add a subcategory (in fact, as the root category is not shown, this new category will be a main category). Add as many categories and subcategories as you need: 3. Create products: Click on “My products” from the main menu in “Catalog”: Click on + to add a product: You can add some sizes/variants to your product. Switch on Product Formats and then fill out sizes/variants information of your product, with a price for each. Note that if you activate this function, you won’t be able to change the price of your product in the main menu as you did just before. The price displayed in the app will be the smallest one (“from 0.30€” for example). You can add some sizes/variants to your product. Switch on Product Formats and then fill out sizes/variants information of your product, with a price for each. Note that if you activate this function, you won’t be able to change the price of your product in the main menu as you did just before. The price displayed in the app will be the smallest one (“from 0.30€” for example). If you check “at least one option is required” the user will have to choose from the sauces you offer when he orders the product. He will not be able to order without choosing one of these options (that’s useful when you have many sizes for a product, as we will see next). Don’t click on "ok" yet, click on + next to “Add options” and add the name of the options you want. Click on "ok" to save. Now, in your product details page you can see your options below: You can also choose to create an option list, for example you are selling sandwiches, and you want your clients to pick one sauce from a list: Then check the categories for your product: And click on "ok" at the top of the page to save your product. You can also duplicate a product if you want to create a new product that doesn’t have many differences from another one: If you have many products in the feature, it can be difficult to scroll to find the one you are looking for. That’s why we implemented a search bar, where you can type its name and find it easily. 4. Manage: In the “Orders” menu, you will be able to see and manage the orders you receive. In the “Settings” menu, you will able to manage the fields required during the order. You can either choose to make a field mandatory, hidden, or simply hide it from the form. Let’s look at an example: And let’s see the result inside the app when ordering: Furthermore, if the user has already created an account in the app and is logged in, some information will automatically be retrieved by the MCommerce feature to fill parts of the form, as you can see in the example above. Then, you will be able to create discounts:
  • “Enabled“: You can enable it right away or disable it for now. You will be able to enable it whenever you want after the creation
  • “Label“: It’s the name of the Discount
  • “Code“: Your client will use this code to activate the Discount
  • “Minimum amount“: Set a minimum amount on the checkout to activate the discount. Leave it blank if there is no minimum amount
  • “Discount type“: “Fixed” for fixed discount, for example 10€, “Percentage” if you want to deduct a percentage
  • “Deductable“: It’s the amount you want to deduct, in your currency if you chose “fixed“, in percentage if you chose “percentage“
  • “Validity date“: Fix a validity date if you want one, leave blank if not
  • “Usable once“: Check this if you want your Discount to be used only once
You can then manage them in the “Manage Discounts” tab: You will also be able to link, for each store, a connected printer to your app to print orders when they arrive. Make sure your printer is compatible, it will need an address mail: You can also setup more taxes if your products don’t use the same taxes: 5.Troubleshoot: I can’t add a product to the cart:
  • You have not created a category (other than the root one)
  • or you have not associated the product to a category
  • or you have not associated the product to a tax.



Audio

In this article, we will learn how it is possible to integrate your playlists or the one of your favorite artists into your app. To create a Music page in your app click on Click on + to create a new playlist: Click on "ok" to save your choice: You have three possibilities to add songs and albums to your playlist:

  • iTunes
  • SoundCloud
  • Podcast
  • Custom
iTunes: Click on the iTunes icon You have three possibilities to search the songs you want to add to your playlist:
  • Artist
  • Album
  • Track
Enter your research in the field, then click on "Search" Click on the album, the track or the artist you want to add to your playlist. Once everything you want is selected, click on "Add" to create the playlist. Soundcloud: Click on Click on "Search", select “Playlist” or “Title” and type your keyword in the field. Select the Title/Playlist you want and click on "Add" to create the Playlist. Podcast: Click on We will use this URL (http://radiofrance-podcast.net/podcast09/rss_14879.xml) as example: Click on "Add" to create the Playlist. Custom: Click on Enter the details of your track, click "ok" and "Save" .



WordPress

With WordPress v2 you can integrate your posts & pages. This new version doesn’t require you to install a plugin and works with all WordPress versions from 4.7.0+ via the native JSON API. General settings 1. First you will add the WordPress Feature to your Application. 2. After what you will see the following configuration page WordPress URL: This is the WordPress you want to fetch posts & pages from. Group all queries into a single list: This one is a display option, in WordPress v2 you can build what we call “queries”. They are collection of posts and/or pages, choosing this option will group all the queries into a single list page like the picture below Otherwise, when not checked, queries will be displayed like “categories/folders” Show cover: this option applies only when the queries are not grouped, and will toggle the Cover display on the homepage. Login / Password: If you want to access posts & pages secured by an account, input your credentials, otherwise leave them blank. Query builder Let’s build our first query, here named The query builder fetched all available categories & pages from our previously configured WordPress, we selected “Tech” which contains 76 posts for our query. And a page query (here Contact) Design In the design section you can upload backgrounds for the feature. Settings The settings section offer two options, the first is the card design alternative The second is related to the cache lifetime, to improve loading times and reduce load on the WordPress server, all queries are cached, however the in-app function “Pull to refresh” automatically rebuilds the cache to fetch fresh content. Default cache lifetime is set to 1 hour. And you’re done!



Folders v2

The Folder feature allows to create an arborescence inside your app. The creation of a Folder To create a folder, click on in the “add pages” part: Give the folder a name and a subtitle. Override layout: It’s a setting useful for the subfolders. You can set a general design on the “design” tab, for all the subfolders, but if you want to use a specific design for a subfolder, you can set it with this setting. To create a subfolder, you have to click on +. If you want to change the name, the subtitle or the cover/thumbnail image, you only have to click on Add features to your Folders
Note: You can ONLY add to your folders the features you have already created. Adding a feature to one of your folders is very easy. First: select the folder in which you want to add a feature. Then click on the feature you want to add to this folder. Here we are. We have added our first feature to a folder. Do the same for each feature you want to add. Editing your features
You will see that, once you have added a feature to a folder, this feature will not appear anymore in the main feature slider. To manage the features you have added on some folders, you have to open the Folders page. Then select the folder or the subfolder in which the feature you want to manage is. Click on the feature you want to edit. To go back to the home of your app, click on this icon Removing a feature from a folder Once you have moved a feature into a folder, you still have the possibility to remove it from it.To do this click on the cross: Costimize your Folder You can customize the appearance of the folder and subfolders with the design tab: In the “Settings” tab, you can add a Search bar, and the “card” design: Without card design: With card design:



How to add internal links / in app links

This functionality allows you to create links to a feature in your app from another feature. From the feature places , custom page : In CK editor (text editor) there is a new button : To open the menu from source code , click on the insert in-app link button : Once you have clicked this button , a new menu pops up :



Places

With this feature, you will be able to create a list of geolocated places. It will display all the places on a map, or, if the user opens the sheet of a particular location, he will be able to get the path and directions to this location, by walking or driving. The listing of the locations is sort according to the distance between the locations and the user, from closest to farthest. Click on on the “Add Pages” section to add the feature to your app: Note: If you want the “Around you” Search Settings, you have to setup it before adding places to the feature. Add Places Click on + to add a Place: Then, you have to enter an address for this location, or its coordinates: If you check the “Display address” checkbox, the address will be shown in the sheet of the location. If you check the “display location button” checkbox, it will display a button that will allow the user to see the path to this location. Be sure you have your Google Maps API Keys set. You can also add other Sections (see Custom Page for more information). When you are done, click on "Save" to add the place. Once you have set up the list, it could look like that: Add Search tabs You can also add a search tab in the feature. You can search your different points of interest based on four types of search: Just check the search filters which should be displayed in your app.

  • “Text” allows you to make a classic search by text (for example, you can search for a “park”)
  • “Type” allows you to search by tags
  • “Address” allows you to search by address
  • “Around you” allows you to only display places in the radius you set up (in km)
Finally, here is the result inside the app:



Offline Mode

The Offline Mode is not really a feature, but it allows your users to download the contents of the app in their phones so that they can access it later, even if they have no connection. Let’s see how this works. When the users download the app and open it for the first time, they will be asked if they want to download the contents to access it when they are offline. If they do it, they will be able to access all the contents that are in the app even when there is no connection. To enable the Offline mode, go in Settings > Advanced: and check “Enable offline content?”: But you have to know that everything that is linked to an external website will not be downloaded, like for example Youtube videos, Instagram galleries, or Facebook pages. As you have to get the content from outside the app, you need an internet connection to access it. Available features:

  • Custom page
  • Push notifications
  • Set meal
  • Folder
  • Contact
  • Newswall
  • Places
  • Code scan
  • Images
  • RSS Feed
  • Tips calculator
  • Topics



Padlock

Thanks to this feature you will be able to lock your app wholly or partly. The locked content will be accessible for authorized users only. We are going to see how to set up this feature. First, you have to add the Padlock feature to your app, click on "PADLOCK" from “Add pages” to add this feature to your app: Unlock by:

  • “QRCode“: Generate a QRCode that, once scanned, will unlock the padlock:
  • “Account“: Unlock the padlock to some accounts. You have to allow accounts manually in the “Users” tab:
  • “Allow all the users by default“: If you select “yes”, all users who have already an account on your app, or users who create an account on your app, will have access to the locked content. If you let on “no”, that means you will have to authorize your users manually from the “Users” menu.
  • “Lock the entire application?“: If you choose “yes”, your whole app will be blocked. With this option you can create a private app. It’s useful, for example, to force your users to create accounts, if you set “Allow all the users by default” and “Lock the entire application” to “yes”. If you choose “no”, you will just block some pages of your app.
  • “Choose the features to lock“: Here you can check the features you want to lock with Padlock, if you set “Lock the entire application?” to “no”.
WARNING: Before submitting an app, create a user (without mentioning “test” or “demo”) with authorized access. Then, when you publish your app on iTunes Connect just fill out these info in the user demo fields to let Apple reviews what is behind the padlock feature. You can change the background of this feature in the “Background” tab:



QR Coupons

This feature will allow you to create discount coupons that will be unlocked by scanning a specific QR Code. Once unlocked, the customer can use the discount when he wants. That means the coupon will not appear in the app for the user until he scans the QR Code. As a business owner you create a QR coupon, and you obtain a QR Code. You can distribute this QR code on your website or in a newsletter, etc… to reward specific actions, or just show it to premium clients so that they can flash it. Once scanned the coupon will appear in their apps. To add it to your app, just click on "QR Coupons" from “Add pages”. Then let’s create a QR Coupon:

  • “Picture”: You can add a picture to illustrate your special offer.
  • “Thumbnail”: Add a thumbnail so your coupon will be more recognizable.
  • “Title”: It’s the name of your coupon.
  • “Description”: Describe it, so there can be no misunderstanding.
  • “Conditions”: The conditions of use.
  • “Use only once?”: Check this if you want your coupon to be a one time use only.
  • “End at”: Specify the end date of your coupon, if not unlimited.
  • “or unlimited?”: Check this if there is no time limit.
Once you’ve set your coupon as you want, click on “OK” at the top of the page. It will create a QR Code that you can print and display anywhere you want to allow the users of the app to scan it to benefit from your QR Coupon!. Note that you don’t have to add the Code Scan feature to your app because your QR coupon will be scanned from the scanner which is in the feature QR Coupon directly (do not scan from the Code Scan feature as it will not work from this feature). You can customize the design of this feature in the “Design” tab:



Weather

This feature offers a weather widget in your app to display the forecasts for a particular city or for your users location. First, click on "WEATHER" in the “Add Pages” section to add the feature to your app: You just have to choose a country and a city, then save. This is how it looks like in your app: Your users will be able to change the location to their own, if they click/tap on “Change location“.



Editor’s Messages feature

This article will explain how to use the Editor’s Messages feature. Sometimes, multiple users want to work on the same app. Appily gives you the ability to share an app between multiple users in order they work together on the same project. But how can they talk to each other about modifications they make, share ideas about the great app they are building? The Editor’s Messages feature comes to answer to these needs. From this feature, directly inside your app Editor, you are now able to share your ideas and tell to the others what you are doing. You can also share images/photos:

  • In the Editor of your app, click on Settings then Messages.
  • Type your message then click on “Send”:
  • The other users will be able to see that message from their Editor and answer you following the same process:



QR Code Scan

This feature will allow your customers to use their camera to flash a QR Code and to access specific content. To add this feature to your app, just click on "Code Scan" in “Add Pages”. Basically, a QR code is data encrypted as an image. When you use your QR Code Scan, it will get you to the content it is linked to. It can be a specific url outside the app, an image, text or anything. For those who don’t know what is a QR Code, it looks like this: Note that each and every QR Code is related to a specific content. (Warning: When you add the QR Code Scan feature, the icon will not be displayed in the Editor Previewer on the right. It is normal, and it will be displayed once the app is published) The QR Code Scan will allow your users to:

  • unlock discount QR coupons
  • unlock the Padlock



Newswall

This feature allows you to create a news page with a photo and comments from users. It works like a news wall, users are able to find all the posts you wrote on it. Click on + to create your news:

  • “Title”: Here is the title of your News”
  • “Date”: Schedule the publication date of your news.
  • “Subtitle”: It’s a summary of the description of the news.
  • Describe your news in the text editor.
  • “Insert a picture”: Chose a picture to illustrate your news.
Here is what it looks like in the app: Click on the news: Your users will be able to comment and like the news: Back to the editor ! You can manage your news via the “Manage content” tab:
  • “Magnifying glass”: Display a summary of the news.
  • “Pen”: Edit the news.
  • “Speech bubble”: Display the comments of the news.
  • “Eye”: Hide the news.
  • “Cross”: Delete the news.
You can choose another design for this page in the “Design” tab: Finally, you can add a Background image for the feature in the “Background” tab:



Booking

Thanks to this feature, your customers can schedule an appointment at your business(es). If you want to add this feature to your application, that is very easy. First of all, you have to click on the Booking feature: Then, you have to click on + and to enter the location of your business and the email address of the manager: If you have several businesses, you can add these businesses to your Booking feature. To do that, you only have to click on + . Then, you just have to enter the location of this business and the email address of your manager. You can do this process, as many time as you want in order to reference all your businesses. Why this information ?
The location of your business(es) is important for your customers, so that they know exactly where they schedule their appointments.
Thanks to the email address of your manager, the application will send him an email to validate the appointment. And the result: Just fill out the different cases you need and your appointment is done!



Twitter

With the Twitter feature you will be able to include your Twitter account in your application.

  1. Create yout Twitter API Keys
To get Twitter Access keys, you need to create a Twitter Application which is mandatory to access Twitter.
  • Go to https://apps.twitter.com/app/new and log in, if necessary
  • Enter your Application Name, Description and your website address. You can leave the callback URL empty.
  • Accept the TOS, and click on “Create your Twitter Application“
  • Save the consumer key (API key) and consumer secret somewhere, in order to use them later in Appily App Builder. After creating your Twitter Application, you have to give the access to your Twitter Account to use this Application. To do this, click the Create my Access Token.
In order to access the Twitter, that is to say get recent tweets and Twitter followers count, you need the four keys such as Consumer Key, Consumer Secret, Access token and Access Token Secret:
Before using the Twitter feature in Appily App Builder, it is necessary to define the Twitter API keys in your editor. So in the editor, click on the menu Settings > APIs:
  • Add the feature Twitter
Click on "TWITTER" in the “Add pages” section: The twitter handle is your personal id on twitter, it starts with the @ symbol. You can check the integrity of your Twitter handle by clicking on: Verify The following error message will appear if you haven’t entered your Twitter API key : The following error message will appear if you have entered a wrong Twitter handle : Otherwise, you will have a confirmation message on your screen like the message below: Then save your changes by clicking on: OK You have now finished to set up your Twitter account in Appily!



Fan Wall

  • Add a Fan Wall
With the Fan Wall feature, users of your application will be able to post comments and/or photos and to discuss among themselves. Click on "FAN WALL" on the “Add Pages” section: You can set the “Near me” settings. It will allow a user to display on the Fan Wall only comments/photos from users around him, in the radius you have determined.
  • Add Posts
You can add posts directly from the Editor by clicking on next to “Add Content“:
  • “Title“: It’s the title of the post
  • “Subtitle“: It will be displayed under the title, it’s a summary of the post.
  • You can create the body of your post in the Text Editor.
  • “Insert a picture“: You will be able to illustrate your post with a picture.
Then create an account or log in (if you already have an account). And then type your message and/or upload a picture.
  • Manage Content
Back to the editor ! You can manage your news via the “Manage content” tab: