@adminide-stack/clock-tik-browser 12.0.18-alpha.0 → 12.0.18-alpha.2

package/lib/templates/content/docs/Alerts.md

@@ -0,0 +1,39 @@
+---
+id: Alert
+title: Alert
+sidebar_label: Alert
+---
+
+To keep a better track of your project estimates, you can set up Alerts and get an email notification when a project has reached a certain percentage of its estimated time.
+
+Alerts is an extra feature, which you can enable by upgrading your workspace to Pro or Enterprise plan. You can try out the feature for free by activating the free 7-day trial (no credit card required).
+
+To get notified when someone tracks too much time, set up overtime reminders.
+
+## Setting up project alerts
+
+1. Click on the Settings on the left sidebar
+2. Switch to Alerts tab
+3. Choose if you'd like Alerts to be sent for projects or tasks, at what percentage of the estimated time, and to whom
+4. Add the alert
+
+Alert will be sent once the set percentage of estimated time is reached. In case someone edits their time and percentage goes below the one that is set, an alert will be sent again once it reaches the set percentage of the estimated time.
+
+Alerts apply to all projects that have estimates (you can't set up alerts just for some specific projects).
+
+If you exclude nonbillable time from project's time estimate, both project status and alerts won't count nonbillable time as part of the estimate.
+
+You can choose who will receive alerts:
+
+1. All admins
+2. All project managers (for their respective projects)
+3. People added to the project (for project alert)
+4. People assigned to the task (for task alert)
+
+**Alerts are sent 30 minutes after the estimated time is reached.**
+
+Users who haven't verified their email address won't receive alerts.
+
+## Removing alerts
+
+To delete the alert, simply click the "X" on the very right hand side of the Alert you'd like to remove and select Delete.

package/lib/templates/content/docs/GPS-tracking.md

@@ -0,0 +1,79 @@
+---
+id: GPS-tracking
+title: GPS tracking
+sidebar_label: GPS tracking
+---
+
+Whenever your team is on the road or on site, they can clock in via their mobile app and you can see their location on the map.
+
+With GPS tracking, you can see who's currently working on site and everyone's location history throughout the day while they were on the clock.
+
+GPS tracking is an extra feature, which you can enable by [upgrading](# 'upgrading') your workspace to Pro or Enterprise plan. You can try out the feature for free by activating the [free 7-day trial](# 'free 7-day trial') (no credit card required).
+
+## Data gathering and privacy
+
+Location can't be tracked without user's knowledge and permission. In order to record the location:
+
+- Admin has to enable "Activate GPS tracking" in workspace settings.
+- All workspace members will get a notification when location recording is enabled via a web and a mobile notification
+- User has to download and track time via the [mobile app](# 'mobile app') (iOS or Android).
+- User has to enable "Location services" on their mobile phone.
+- User has to allow the Clockify app to access their location.
+- Each regular user can see all their recorded locations. Admin sees all recorded locations in the workspace.
+- Location is recorded every time the TIMER IS STARTED AND STOPPED IN THE MOBILE APP. Also, while the timer is running , more locations will be recorded if the user moves significantly (usually more than 500m) - but this varies depending on your device (its operating system, version, settings, and granted permissions).
+- Locations are collected even if the mobile app works in the background.
+- Each location is tied to a time entry. If the time entry is deleted, its locations are deleted also.
+- Admins can delete anyone's location. Regular users can delete their own location.
+- You can view locations for the past 7 days. All locations older than 30 days are deleted forever automatically.
+
+## Viewing locations
+
+To view recorded locations, click on Activity in the sidebar, and then the Locations tab.
+
+Admins can view everyone's recorded location, while regular users can see only their own.
+
+You can see current locations of your staff, their routes, and time stamps of when the location was recorded.
+
+On the right side, you can see all active users in your workspace, plus their last recorded location on the map for that day as well as the timestamp when it was recorded. If a user doesn't have any location that day, you'll see just a hyphen (-).
+
+If a user has a red "recording" dot next to them, it means they still have the timer running at that location.
+
+To see a user's all recorded locations in the day, click on them in the sidebar. You'll get a list of all the records, plus you'll be able to see their route on the map (based on recorded locations that day).
+
+To close the detailed view and get back to the team overview, click on X next to the user's name.
+
+To see locations for other days, click on < or > in the upper right corner next to the date (you can go back up to past 7 days).
+
+## Deleting location
+
+Both admins and regular users can delete recorded locations.
+
+You can delete recorded locations on the web version of Clockify, when you go to Activity > Locations from the sidebar.
+
+If you're admin, click on a user on the right to enter their route view, hover over the location you wish to delete, and click on the trash icon.
+
+If you're a regular user, just hover over the record you wish to delete and click on the trash icon.
+
+All locations older than 7 days are deleted forever automatically.
+
+There is no undo when a location is deleted (each delete is permanent and non-retrievable.).
+
+If a user deletes their account, all their location data is deleted too.
+
+## Location accuracy
+
+GPS location tracking is not 100% accurate due various facts (phone’s operating system, version, model, closed vs open space, geographic factors like tallness of buildings, etc.).
+
+Location accuracy can be:
+
+- High accuracy - Real location can be off by less than 150m (500ft)
+- Medium accuracy - Real location is off by 150-500m (500-1,60 0ft)
+- Low accuracy - Real location is off by 500-1,000m (1,600-3,200ft)
+
+When the recorded location has medium or low accuracy, you'll get an indicator in the person's detailed route view.
+
+If the location accuracy is off by more than 1,000m (3,200ft), it won't be recorded.
+
+[Improving location accuracy (Android)](# 'Improving location accuracy (Android)')
+
+[Improving location accuracy (iOS)](# 'Improving location accuracy (iOS)')

package/lib/templates/content/docs/Invoicing.md

@@ -0,0 +1,108 @@
+---
+id: Invoicing
+title: Invoicing
+sidebar_label: Invoicing
+---
+
+**To create invoices, you first need to enable "Invoicing" in workspace settings.**
+
+Create invoices for clients based on tracked time, and mark entries as invoiced so you don't double bill clients.
+
+Invoicing is an extra feature, which you can enable by [upgrading](# 'upgrading') your workspace to Standard, Pro, or Enterprise plan. You can try out the feature for free by activating the [free 7-day trial](# 'free 7-day trial') (no credit card required).
+
+## Creating invoices
+
+- Enable Invoicing in the Workspace settings
+- Go to Invoices page from sidebar
+- Click "Create invoice"
+- Choose client
+- Change currency, invoice number, and issue/due dates (if needed)
+- Click "Create"
+- Manually add items to the invoice or import your tracked time
+- Download PDF
+  You can enter what the invoice is about in the **Subject** field (which will appear at the top of the invoice), and you can enter additional information at the **Notes** fields (which will appear at the end of the invoice).
+
+**"Bill from"** name, address, and logo are taken from your workspace settings, and "**Bill to"** address is taken from the client (you can edit client address by going to the Clients page and click on the edit icon for some client).
+
+## Managing invoices
+
+On the Invoices page, you can see all your invoices, mark them as Sent/Paid/Void, and filter by status.
+
+You can also edit, delete, and change status of an invoice by clicking on some invoice, and then choosing an action from the Actions dropdown in the upper right corner.
+
+Invoices that are marked as paid can't be edited. To edit a paid invoice, you first need to mark it as either Unsent or Sent.
+
+You can add **Tax** and **Discount** to each invoice. Just click what you wish to add, enter number, and it will be added to the invoice in form of a percentage. Discount is applied to the invoice's subtotal, and then the Tax is applied on the final result.
+
+If you're using **Tax 2**, you can choose how it's calculated by going to the Invoice page > Settings > Defaults tab, and then clicking "Add second tax" to get the "Taxation Mode" options (this setting is applied to all your invoices):
+
+- **Simple** - both taxes are applied on the total (eg. if subtotal $100, 10% tax1 is $10, 10% tax2 is $10, and total is $120)
+- **Compounded** - second tax is applied on the taxed amount (eg. if subtotal $100, 10% tax1 is $10, 10% tax2 is $11, and total is $121)
+
+## Invoicing tracked time
+
+1. Open the invoice and click "Import time"
+2. Choose which projects for that client you wish to invoice
+3. Choose from which period you wish to invoice time entries
+4. Choose how you wish to group items in the invoice:
+
+- Single item - all hours will be merged into one line item
+- Detailed - each time entry will be listed as an individual line item
+- Grouped - group hours by project, user, or date (and further subgroup project, user, date, or description)
+
+5. Choose if you wish to round imported time
+6. Click "Import"
+   Import will take all time entries that match the chosen date range and selected project.
+
+You can set [time rounding ](# 'time rounding ') option in workspace settings. When you round time, each individual time entry is rounded (and not just the final total).
+
+You can only import time entries that are both uninvoiced and billable.
+
+After the import is done, invoice items will be automatically populated and all appropriate time entries will be automatically marked as invoiced.
+
+If you delete some line item, all time entries from that item will lose their invoiced status.
+
+You can edit line items from imported as you want (eg. change description, amount, or cost), and it won't affect the actual time entries.
+
+You can import time into an invoice multiple times (the only limit is that it has to be the same client).
+
+If you delete the whole invoice, all its entries will be marked as uninvoiced.
+
+## Invoicing expenses
+
+You can invoice fixed fees and other project related expenses by enabling **Expenses** and adding expenses (either by sum or unit).
+
+## Conversion from clock to decimal format
+
+**Total amount between reports and invoices may slightly differ.**
+
+Invoices round time on two decimals, while reports take more decimals into account. For example, let's say you have a time entry whose duration is 20min, or 0.3333333h when converted to decimal format. When a report multiplies it with hourly rate of $100, the result in report is $33.33. But when that entry is imported into an invoice, the invoice imports time rounded to two decimals (0.33h), which when multiplied with $100 equals $33.00.
+
+**Grouping option may also result in different total amounts.**
+
+Let's say you have three entries on some project, each 20min. If you import time one by one with the "Group hours: Detailed" option. the invoice will make three line items of 0.33 and total amount will be $99.00 (3 x 0.33h x $100). But if you choose "Group hours: Project" option, they will be summed up and rounded using more decimals (like in the reports), resulting in $100.00 invoice.
+
+**To avoid discrepancy due to decimal rounding, round time up, down, or to nearest 6/12/15/30 minutes (i.e. any number divisible by six).**
+
+## Settings
+
+You can get **invoices in another language**or name things differently (eg. change label from "Tax" to "VAT"):
+
+1. Click on the cog icon (Settings) next to the "Create invoice" button on the Invoices page
+2. For each label, enter what you wish to be displayed instead
+3. Each PDF you generate will now display the new labels
+   When you create a new invoice, it can inherit some **predefined subject, note, issue date, and tax**. You can set defaults by clicking on the cog icon (Settings) on the Invoices pages > Defaults tabs.
+
+You can h**ide Quantity and Unit Price** columns from PDF invoices on the Appearance tab in Invoice Settings. There you can also set if you wish text to be displayed right-to-left.
+
+## Marking time as invoiced manually
+
+Time entries that are invoiced have a green "invoiced" tag next to them in the Detailed report.
+
+When you hover over the "invoiced" tag, you'll see the client and the invoice ID under which the time entry was invoiced (unless it was manually marked as invoiced).
+
+You can filter reports by invoiced/uninvoiced status from the Status filter.
+
+To manually mark time as invoiced, select all time entries you need via bulk edit, and then click on "Mark as invoiced" (located next to "Bulk edit" in the table header).
+
+To mark time as uninvoiced, select only invoiced time entries and click "Mark as uninvoiced".

package/lib/templates/content/docs/Screenshots.md

@@ -0,0 +1,79 @@
+---
+id: Screenshots
+title: Screenshots
+sidebar_label: Screenshots
+---
+
+Generate screenshots randomly every 5 minutes while the timer is running.
+
+[Download screenshot recording app→](# 'Download screenshot recording app→')
+
+Screenshots is an extra feature, which you can enable by [upgrading](# 'upgrading') your workspace to Pro or Enterprise plan. You can try out the feature for free by activating the [free 7-day trial](# 'free 7-day trial') (no credit card required).
+
+## Data gathering and privacy
+
+Screenshots can't be recorded without user's knowledge.
+
+In order to record screenshots:
+
+- **Admin has to enable "Activate screenshot capturing" in workspace settings**
+
+- All workspace members will receive a notification when screenshot capturing is enabled via both the web and the desktop app
+- User has to install the screenshot recording app
+- Screenshots are taken only while the timer is running (no matter from where you started the timer) AND you have the screenshot recording app installed
+- Screenshots are captured once every 5 minutes, at a random moment
+- If you use two monitors, the app will take screenshots of both monitors at the same time
+- Screenshots are low-resolution and blurred by default for privacy and security reasons
+- Each regular user can see all their screenshots. Admin sees all screenshots in the workspace
+- Each screenshot is tied to a time entry. If the time entry is deleted, its screenshots are deleted also
+- If a user deletes a screenshot, the time between the previous and current screenshot will be subtracted from the total time
+- You can view screenshots for the past 7 days. All screenshots older than 7 days are deleted forever automatically.
+
+Clockify can also:
+
+- Record what apps you use and websites you visit using auto tracker, but that data is completely private (data is not available to workspace admins).
+- Detect when you're inactive using idle detection (no mouse movement or keystrokes), but that data is shown only once when become active again so you can decide if you wish to keep or exclude idle time (information is not available to workspace admins).
+
+## Record screenshots
+
+To capture screenshots, you need to install the [screenshot recording app](# 'screenshot recording app') for Mac or Windows.
+
+Once installed, you'll need to log in and start the timer.
+
+Screenshots are captured randomly in every 5-minute interval while the timer is running and the desktop app is active.
+
+If you have the timer running on the web or mobile, but the desktop app is not running (or you aren't logged in), screenshots won't be captured.
+
+Note for Mac: When Mac prompts you, you have to allow Clockify to take screenshots. If you click Deny, you'll have to go to "System Preferences > Security & Privacy > Screen Recording" and check Clockify app.
+
+## Viewing screenshots
+
+When screenshots are enabled, all users in the workspace will see the Activity > Screenshots page in the sidebar.
+
+Regular users can see all their personal screenshots, and admins can see everyone's.
+
+All active users in the workspace are listed, and next to each person you can see the total number of recorded screenshots in that day.
+
+If a person has screenshots, you can click on their name or the expand icon in the right corner to see the screenshots and when each was recorded.
+
+You can click on a screenshot to open gallery view, and then go back and forth between screenshots.
+
+To see screenshots for other days, click on < or > in the upper right corner next to the date (you can go back up to past 7 days).
+
+## Deleting screenshots
+
+Both admins and regular users can delete screenshots by clicking on the trash icon when you hover over some screenshot.
+
+Regular users can delete only their personal screenshots - unless the time entry is locked or approved (in which case the admin needs to do delete it).
+
+To delete a screenshot that was captured from a currently running timer, you first need to stop the timer, and then you can delete the desired screenshot.
+
+When screenshot is deleted by a regular user, the time between that and the screenshot before it will be subtracted from the time entry's total time. If an entry has only one screenshot, the whole time entry will be deleted. Deleting a screenshot for an approved time entry won't affect the entry.
+
+Admins can delete anyone's screenshot without the time subtraction.
+
+If a time entry that has a screenshot is deleted by users or admin, all its screenshots are deleted automatically. If a user deletes their account, all their screenshots are deleted also.
+
+All screenshots older than 7 days are deleted forever automatically.
+
+**There is no undo when a screenshot is deleted. Each delete is permanent and non-retrievable.**

package/lib/templates/content/docs/add-time-for-others.md

@@ -0,0 +1,45 @@
+---
+id: add-time-for-others
+title: Add time for others
+sidebar_label: Add time for others
+---
+
+As an admin, you can see your team members' timesheets and add time on their behalf.
+
+Adding time for others is an extra feature, which you can enable once by [upgrading](# 'upgrading') your workspace to any of the paid plans. You can try out the feature for free by activating the [free 7-day](# 'free 7-day') [trial (no credit card required).](# 'trial (no credit card required).')
+To assign people to a group:
+
+## Adding time in Timesheet
+
+1. Go to your Timesheet Page
+2. Click the Teammates button and select a Teammate to view their Timesheet
+3. Choose a Project or a Task
+4. Add/edit time for that Teammate
+
+**Please note that you would first need to enable Timesheet View in order to see the Timesheets. You can do this in the Workspace settings.**
+
+## Adding time in the Detailed report
+
+If you need to be more specific regarding the time entry, you can add time on your team members' behalf directly from Detailed Reports page with just a few clicks.
+
+You can add time for a one or multiple users at once.
+
+1. Hover over Reports on the sidebar and click Detailed
+2. Click "Add time for others" button
+3. Click "Select user"
+4. Choose members or groups for whom you would like to add time
+5. Enter start and end time and pick a date
+6. Click Add
+
+You can also add a description, select a project, add tags and choose if the time entry is billable or not.
+
+In addition to adding time for someone else, you can also reassign entries to a different user. You can reassign entries one by one (by clicking on entry's user and choosing a different person), or in bulk form [the bulk edit screen](# 'the bulk edit screen').
+
+**Have in mind that only owner or admins can add or edit another person’s time entries. Regular users can only edit their own time entries.**
+
+## Add time in Calenda
+
+1. Go to the Calendar page
+2. Click the Teammates button and select a Teammate to view their Calendar
+3. Click on any open time slot to add a time entry
+4. Click and drag up or down to create a time entry for the desired time slot

package/lib/templates/content/docs/api/directives/additional-labels.mdx

@@ -0,0 +1,28 @@
+---
+id: additional-labels
+title: additionalLabels
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+No description
+
+```graphql
+directive @additionalLabels(
+  labels: [String] = []
+)
+```
+
+### Arguments
+
+#### `labels` ([`[String]`](/docs/api/scalars/string))

package/lib/templates/content/docs/api/directives/cypher.mdx

@@ -0,0 +1,28 @@
+---
+id: cypher
+title: cypher
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+No description
+
+```graphql
+directive @cypher(
+  statement: String
+)
+```
+
+### Arguments
+
+#### `statement` ([`String`](/docs/api/scalars/string))

package/lib/templates/content/docs/api/directives/deprecated.mdx

@@ -0,0 +1,30 @@
+---
+id: deprecated
+title: deprecated
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+Marks an element of a GraphQL schema as no longer supported.
+
+```graphql
+directive @deprecated(
+  reason: String = "No longer supported"
+)
+```
+
+### Arguments
+
+#### `reason` ([`String`](/docs/api/scalars/string))
+
+Explains why this element was deprecated, usually also including a suggestion for how to access supported similar data. Formatted using the Markdown syntax, as specified by [CommonMark](https://commonmark.org/).

package/lib/templates/content/docs/api/directives/id.mdx

@@ -0,0 +1,22 @@
+---
+id: id
+title: id
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+No description
+
+```graphql
+directive @id
+```

package/lib/templates/content/docs/api/directives/include.mdx

@@ -0,0 +1,30 @@
+---
+id: include
+title: include
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+Directs the executor to include this field or fragment only when the `if` argument is true.
+
+```graphql
+directive @include(
+  if: Boolean!
+)
+```
+
+### Arguments
+
+#### `if` ([`Boolean!`](/docs/api/scalars/boolean))
+
+Included when true.

package/lib/templates/content/docs/api/directives/index.mdx

@@ -0,0 +1,22 @@
+---
+id: index
+title: index
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+No description
+
+```graphql
+directive @index
+```

package/lib/templates/content/docs/api/directives/mutation-meta.mdx

@@ -0,0 +1,34 @@
+---
+id: mutation-meta
+title: MutationMeta
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+No description
+
+```graphql
+directive @MutationMeta(
+  relationship: String
+  from: String
+  to: String
+)
+```
+
+### Arguments
+
+#### `relationship` ([`String`](/docs/api/scalars/string))
+
+#### `from` ([`String`](/docs/api/scalars/string))
+
+#### `to` ([`String`](/docs/api/scalars/string))

package/lib/templates/content/docs/api/directives/neo-4-j-ignore.mdx

@@ -0,0 +1,22 @@
+---
+id: neo-4-j-ignore
+title: neo4j_ignore
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+No description
+
+```graphql
+directive @neo4j_ignore
+```

package/lib/templates/content/docs/api/directives/relation.mdx

@@ -0,0 +1,37 @@
+---
+id: relation
+title: relation
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+No description
+
+```graphql
+directive @relation(
+  name: String
+  direction: _RelationDirections
+  from: String
+  to: String
+)
+```
+
+### Arguments
+
+#### `name` ([`String`](/docs/api/scalars/string))
+
+#### `direction` ([`_RelationDirections`](/docs/api/enums/relation-directions))
+
+#### `from` ([`String`](/docs/api/scalars/string))
+
+#### `to` ([`String`](/docs/api/scalars/string))

package/lib/templates/content/docs/api/directives/skip.mdx

@@ -0,0 +1,30 @@
+---
+id: skip
+title: skip
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+Directs the executor to skip this field or fragment when the `if` argument is true.
+
+```graphql
+directive @skip(
+  if: Boolean!
+)
+```
+
+### Arguments
+
+#### `if` ([`Boolean!`](/docs/api/scalars/boolean))
+
+Skipped when true.

package/lib/templates/content/docs/api/directives/specified-by.mdx

@@ -0,0 +1,30 @@
+---
+id: specified-by
+title: specifiedBy
+---
+
+export const Tag = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+Exposes a URL that specifies the behaviour of this scalar.
+
+```graphql
+directive @specifiedBy(
+  url: String!
+)
+```
+
+### Arguments
+
+#### `url` ([`String!`](/docs/api/scalars/string))
+
+The URL that specifies the behaviour of this scalar.