Skip to content

Commit

Permalink
Update
Browse files Browse the repository at this point in the history
Updated the documentation to show more of the "in use" features
  • Loading branch information
Makhuta committed Sep 3, 2024
1 parent d132404 commit eeb99e6
Show file tree
Hide file tree
Showing 13 changed files with 138 additions and 8 deletions.
73 changes: 69 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Adds multiple sensors, button with information/statistics/functions grabbed from

### Adding new device

To add the **HoneyGain Scrapper** integration to your Home Assistant, use this My button:
To add the **Crafty Controller** integration to your Home Assistant, use this My button:

<a href="https://my.home-assistant.io/redirect/config_flow_start?domain=crafty_controller" class="my badge" target="_blank"><img src="https://my.home-assistant.io/badges/config_flow_start.svg"></a>

Expand All @@ -24,12 +24,77 @@ If the above My button doesn’t work, you can also perform the following steps

- In the bottom right corner, select the [Add Integration button.](https://my.home-assistant.io/redirect/config_flow_start?domain=crafty_controller)

- From the list, select **HoneyGain Scrapper**.
- From the list, select **Crafty controller**.

- Follow the instructions on screen to complete the setup.

</details>

## None
## Examples

The users will be viewed from the JWT token point of view meaning that you might not see some datas when parsing other users with the same token.
### Installed device

![Instance](./imgs/instance.png)

This is the example of how succesfully installed Crafty integration should look like (there can be some differences in the number of devices/entities based on your *Crafty Controller* installation)

### All devices

![All devices](./imgs/devices.png)
At all time there will be at least 3 devices (All Roles, All Servers and All Users) and based on your Crafty installation there will be added another devices for each of them to provide nice UI.

### All roles

![All roles](./imgs/all_roles.png)

The Roles sensor will show the number of roles based on your specific settings and it will have connected the respective number of devices (roles) which will each have their own sensors

#### Examples for _testing role 1_
![Example role](./imgs/example_role.png)

##### Example of _Server access_
![Example role server access](./imgs/example_role_server_access.png)

Here you can see the number of servers **Role** has access to and the list of permissions for each server in sensor attributes.

##### Example of _Users_
![Example role users](./imgs/example_role_users.png)

This sensor shows the number of **Users** asigned to this role with list of users in its attributes.

### All users

![All users](./imgs/all_users.png)

The Users sensor will show the number of users your Crafty installation has (at least 1 should be there because you need the admin to log-in into the API)

#### Example for _admin_

![Example user](./imgs/example_user.png)

##### Example of _Roles_

![Example user roles](./imgs/example_user_roles.png)

In this part the integration will provide you with ability to see the number of roles the **User** has been assigned to and in attributes you can see the list of their names.

### All servers

![All Servers](./imgs/all_servers.png)

Here you are able to se 2 sensors:

1. **Servers Offline**: This will show the number of servers that are offline
2. **Servers Online**: This will obviously show the number of online servers

and next you can see that there are mentioned the servers that you have running (added) in Crafty Controller.

#### Example for _Majnr+_

![Example server](./imgs/example_server.png)

Here you can at the first glance see that there is some controlls, with these you are able to control the respective server based on the button name. Next you can see multiple statistics of the selected server.

## Note

If you spot any sort of bug, error or incostintency don't hesitate to open issue [here](https://github.com/Makhuta/homeassistant-crafty_controller/issues).
Binary file added imgs/all_roles.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/all_servers.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/all_users.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/devices.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/example_role.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/example_role_server_access.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/example_role_users.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/example_server.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/example_user.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/example_user_roles.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/instance.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
73 changes: 69 additions & 4 deletions info.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Adds multiple sensors, button with information/statistics/functions grabbed from

### Adding new device

To add the **HoneyGain Scrapper** integration to your Home Assistant, use this My button:
To add the **Crafty Controller** integration to your Home Assistant, use this My button:

<a href="https://my.home-assistant.io/redirect/config_flow_start?domain=crafty_controller" class="my badge" target="_blank"><img src="https://my.home-assistant.io/badges/config_flow_start.svg"></a>

Expand All @@ -24,12 +24,77 @@ If the above My button doesn’t work, you can also perform the following steps

- In the bottom right corner, select the [Add Integration button.](https://my.home-assistant.io/redirect/config_flow_start?domain=crafty_controller)

- From the list, select **HoneyGain Scrapper**.
- From the list, select **Crafty controller**.

- Follow the instructions on screen to complete the setup.

</details>

## None
## Examples

The users will be viewed from the JWT token point of view meaning that you might not see some datas when parsing other users with the same token.
### Installed device

![Instance](./imgs/instance.png)

This is the example of how succesfully installed Crafty integration should look like (there can be some differences in the number of devices/entities based on your *Crafty Controller* installation)

### All devices

![All devices](./imgs/devices.png)
At all time there will be at least 3 devices (All Roles, All Servers and All Users) and based on your Crafty installation there will be added another devices for each of them to provide nice UI.

### All roles

![All roles](./imgs/all_roles.png)

The Roles sensor will show the number of roles based on your specific settings and it will have connected the respective number of devices (roles) which will each have their own sensors

#### Examples for _testing role 1_
![Example role](./imgs/example_role.png)

##### Example of _Server access_
![Example role server access](./imgs/example_role_server_access.png)

Here you can see the number of servers **Role** has access to and the list of permissions for each server in sensor attributes.

##### Example of _Users_
![Example role users](./imgs/example_role_users.png)

This sensor shows the number of **Users** asigned to this role with list of users in its attributes.

### All users

![All users](./imgs/all_users.png)

The Users sensor will show the number of users your Crafty installation has (at least 1 should be there because you need the admin to log-in into the API)

#### Example for _admin_

![Example user](./imgs/example_user.png)

##### Example of _Roles_

![Example user roles](./imgs/example_user_roles.png)

In this part the integration will provide you with ability to see the number of roles the **User** has been assigned to and in attributes you can see the list of their names.

### All servers

![All Servers](./imgs/all_servers.png)

Here you are able to se 2 sensors:

1. **Servers Offline**: This will show the number of servers that are offline
2. **Servers Online**: This will obviously show the number of online servers

and next you can see that there are mentioned the servers that you have running (added) in Crafty Controller.

#### Example for _Majnr+_

![Example server](./imgs/example_server.png)

Here you can at the first glance see that there is some controlls, with these you are able to control the respective server based on the button name. Next you can see multiple statistics of the selected server.

## Note

If you spot any sort of bug, error or incostintency don't hesitate to open issue [here](https://github.com/Makhuta/homeassistant-crafty_controller/issues).

0 comments on commit eeb99e6

Please sign in to comment.