stinkyrat / Webasyst-X-iOS

Simple native iOS demo app that authenticates users via Webasyst ID and connects to Blog, Site, and Shop-Script server apps APIs. A handy sample for developing custom native iOS client apps for just any Webasyst server-side app.

Webasyst-X-iOS

Simple native iOS app that authenticates users via Webasyst ID and enables direct access to all linked Webasyst accounts APIs.

Usage

Generating code

The Generamba template (https://github.com/strongself/Generamba) is created in the application. You can use the terminal command diff +***generamba gen [Module Name] WebasystModule***.

To fix or edit a code generation template, use the template at the path */Templates/WebasystModule/Code

External Dependencies The following libraries are required for the application:

- pod RxSwift
- pod RxCocoa
- pod Moya
- pod Moya/RxSwift
- pod Webasyst (https://github.com/1312inc/Webasyst-X-iOS-Pod)

Extensions The following are methods that are added as extensions to the UIViewController.

createLeftNavigationButton - method for creation of a button to open settings list. It sets either the logo of the user's active installation or if there are no settings - puts a sandwich.

setupLayoutTableView - Sets the table with the output results. You must pass a UITableView with cells to work.

setupEmptyView - Method to display the View with an empty screen error (in case of empty server response)

setupServerError - Displays a server error. Requires error text in String format.

setupLoadingView - Display the loading indicator.

setupInstallView - Displays a message about the need to install the module in Webasyst. Requires the InstallModuleViewDelegate protocol to be passed to the ViewController comform method.

setupNotConnectionError - Displaying an error about a missing Internet connection

Creating a new application from scratch To create an application based on the Webasyst library, add pod webasyst to your pod-file and run pod install. After that, execute pod install in the terminal.

To import it into your application's controller, write import Webasyst in the controller's import list.

To configure the library, create a file Webasyst.plist, in the root folder of the project, with the following content:

"clientId": String // *clientId of your application. Example: "72at75391ea785412a24f4568528ed49"*
"host": String // *host of your server, or the host of the Webasyst central serve. Example: "www.webasyst.com "r*
"scope": String: // //the scope required by your application (separated by dot). Example: "site.blog.shop "*

a File example

Note More documentation on Webasyst you can get here

Running the example app with Xcode To run the app project:

1. Clone file Webasyst X/Webasyst.plist.example.plist -> Webasyst X/Webasyst.plist
2. Obtain your Webasyst ID client Id from Webasyst and save it into this new .plist file.
3. Run pod install in the terminal
4. Launch Xcode.
5. Open WebasystX.xcworkspace.
6. Launch the app!