Skip to content
Snippets Groups Projects
README.md 1.64 KiB
Newer Older
Bekerle, Patrizio's avatar
Bekerle, Patrizio committed
# Person Profile Web Component
Bekerle, Patrizio's avatar
Bekerle, Patrizio committed

You can install this component via npm:

```bash
npm i @dbp-toolkit/person-profile
```

Bekerle, Patrizio's avatar
Bekerle, Patrizio committed
## Usage

```html
<dbp-person-profile></dbp-person-profile>
<script type="module" src="node_modules/@dbp-toolkit/person-profile/dist/dbp-person-profile.js"></script>
Bekerle, Patrizio's avatar
Bekerle, Patrizio committed
```

Or directly via CDN:

```html
<dbp-person-profile></dbp-person-profile>
<script type="module" src="https://unpkg.com/@dbp-toolkit/person-profile@0.2.2/dist/dbp-person-profile.js"></script>
```

Bekerle, Patrizio's avatar
Bekerle, Patrizio committed
## Attributes

- `lang` (optional, default: `de`): set to `de` or `en` for German or English
    - example `<dbp-person-profile lang="de"></dbp-person-profile>`
Bekerle, Patrizio's avatar
Bekerle, Patrizio committed
- `entry-point-url` (optional, default is the TU Graz entry point url): entry point url to access the api
    - example `<dbp-person-profile entry-point-url="http://127.0.0.1:8000"></dbp-person-profile>`
- `value` (optional): api path of person to preload the selector with
    - example `<dbp-person-profile value="/base/people/testuser"></dbp-person-profile>`
- `auth` object: you need to set that object property for the auth token
    - example auth property: `{token: "THE_BEARER_TOKEN"}`
    - note: most often this should be an attribute that is not set directly, but subscribed at a provider
Bekerle, Patrizio's avatar
Bekerle, Patrizio committed

## Local development

```bash
# get the source
git clone git@gitlab.tugraz.at:dbp/web-components/toolkit.git
cd toolkit/packages/person-profile
Bekerle, Patrizio's avatar
Bekerle, Patrizio committed

# install dependencies
yarn install
Bekerle, Patrizio's avatar
Bekerle, Patrizio committed

# constantly build dist/bundle.js and run a local web-server on port 8002 
Bekerle, Patrizio's avatar
Bekerle, Patrizio committed

# run tests
yarn test

# build local packages in dist directory
yarn run build
Bekerle, Patrizio's avatar
Bekerle, Patrizio committed
```

Jump to <http://localhost:8002> and you should get a Single Sign On login page.