# Config guide

## Configurations

Publication Planner needs to be configured with Content-Agent, ICP and Writer providers and endpoints.

* Go to Plugins > Publication Planner > settings > Configurations
* Add OpenContent ContentProvider name.
* Add QueryStreamer ContentProvider name.
* Add your Publication Planner config inside the config editor.
* Click save.

Publication Planner also needs to be configured with requirements in Mappings section

* Go to Plugins > Publication Planner > settings > Mappings
* Select all the required actions by selecting from the dropdown for each required action.

## Add filter query to your search request

**available with v3.0.0 or higher**

In your config you can add `filterQuery` to add custom filter to your searches

> example

```javascript
{
    ...,
    "filterQuery": "NOT WriterAuthors:\"John Doe\"",
    ...,
}
```

## Add slugline to Article cards

In your config object you can add your `Slug` OC-Property in `ocProperties` and map it in `articlePropertyMap` as a `Slugline`

> **example**

```javascript
{
    ...,
    "ocProperties": [
        "...",
        "Slug",
        "..."
    ],
    "articlePropertyMap": {
        "...": "...",
        "Slugline": "Slug",
        "...": "..."
    },
    ...,
}
```

> **results**

![publication-planner-slugline](https://camo.githubusercontent.com/f7ce2ae01112c31eeca5e15d18c8536dc52e8299/68747470733a2f2f73332d65752d776573742d312e616d617a6f6e6177732e636f6d2f64617368626f6172642d67726170686963732f7075626c69636174696f6e2d706c616e6e65722d736c75676c696e652e706e67)

## ArticlePropertyMap

```json
"articlePropertyMap": {
    "Uuid": "uuid",
    "ImageURIs": "ArticleMetaImageUuids",
    "Published": "WriterPubStart",
    "Status": "WriterPubStatus",
    "Channels": "ArticleMetaChannels",
    "ContentProfiles": "ArticleContent",
    "Authors": "WriterAuthors",
    "Headline": "Headline",
    "NewsPrio": "ArticleMetaNewsValue",
    "NewsPrioLifetime": "ArticleMetaLifeTime",
    "Products": "ArticleMetaChannels",
    "PubStart": "WriterPubStart",
    "PubStop": "WriterPubStop",
    "HasPublishedVersion": "WriterHasPublishedVersion",
    "Updated": "updated",
    "AssignmentUuid": "ArticleMetaAssignmentUuid"
},
```

## Start and stop time in Scheduled Publication

Don't forget to add start and stop time to config to make Scheduled publication show properly.

![](https://content.gitbook.com/content/8jEx6JyF4EzBk3sc5FWO/blobs/uao9U97zMV2eQFgei0ya/Ska%CC%88rmavbild%202020-09-18%20kl.%2016.02.25.png)![](https://content.gitbook.com/content/8jEx6JyF4EzBk3sc5FWO/blobs/pJahg5YI6gylnv97swf4/Dashboard.png)

## Open Assignment

In order to open Assignments from article cards, you need to have the "**Open assignments**" action mapped in settings, and add the following config:

```javascript
"ocProperties": [
    ...,
    "ArticleMetaAssignmentUuid"
    ...
],
"articlePropertyMap": {
    ...
    "AssignmentUuid": "ArticleMetaAssignmentUuid"
    ...
}
```

## Drag and Drop

{% hint style="warning" %}
**In order to make DND work you should check the following:**

* `articleExtractors` is configured
* `publisherId` is configured
* `PubStart, PubStop, WriterHasPublishedVersion` is configured in ocProperties config

**Using proxy**

* Configure Writer to allow requests from Dashboard IP

**Using fetch**

* Configure Writer to allow Dashboard domain to do CORS requests
  {% endhint %}