connector

Looking for an english version?

Ponty Connector är ett WordPress-plugin som kopplar samman Ponty Recruitment System med din WordPress-sajt. Annonser som publiceras i Ponty skickas automatiskt till WordPress där de kan visas och anpassas.

Ladda ner senaste versionen (1.0.15)

Hur det fungerar

Pluginet gör tre saker:

1. Skapar två Custom Post Types: pnty_job (aktiva annonser) och pnty_job_showcase (referensannonser/avslutade)
2. Tar emot annonsdata från Ponty via ett autentiserat API
3. Exponerar metadata via WordPress REST API, Elementor Dynamic Tags och Gutenberg Block Bindings

Pluginet hämtar aldrig data. Annonserna skickas från Ponty-systemet till din WordPress-installation. När de väl finns i WordPress hanteras de som vanligt WordPress-innehåll.

Installation

1. Ladda ner zip-filen ovan
2. I WordPress: Plugins → Lägg till → Ladda upp plugin
3. Aktivera pluginet
4. Gå till Inställningar → Ponty Connector och mata in din API-nyckel (finns i Ponty-systemet)
5. Gå till Inställningar → Permalänkar och klicka Spara (behövs för att URL-sluggarna ska fungera)
6. Publicera en annons i Ponty – den dyker upp i WordPress automatiskt

Inställningar

Under Inställningar → Ponty Connector finns följande:

Grundinställningar

API-nyckel

Autentiseringsnyckel som matchar den i Ponty-systemet.

URL-slug (aktiva annonser)

Styr URL-strukturen, t.ex. /jobs/mitt-jobb. Standard: jobs

URL-slug (referensannonser)

Motsvarande för referensannonser. Standard: showcase-jobs

Visa kundlogotyp i annons

Visar organisationens logotyp ovanför annonstexten (om en logotyp finns). Stäng av om du visar logotypen via Elementor eller Gutenberg istället.

Plats för ansökningsknapp

Styr var ansökningsknappen visas i annonstexten: längst ner, längst upp, båda, eller inte alls.

Avancerade inställningar

Extern CSS-fil

URL till en extern CSS-fil som laddas på annonssidor.

Open Graph-taggar

Genererar OG-meta-taggar automatiskt. Använd bara om inget annat OG-plugin finns.

JSON-LD (JobPosting)

Lägger till strukturerad data i JobPosting-format för sökmotorer.

Visa utdrag

Visar annonsens utdrag/excerpt ovanför annonstexten.

Delningsknappar

Visar knappar för delning på Facebook, LinkedIn och X (Twitter).

Webhook-URL:er

Kommaseparerade URL:er som triggas med en POST-förfrågan när en ny annons publiceras. JSON med value1 (titel) och value2 (URL).

Visa annonser

Det finns fyra sätt att visa annonsdata. Välj det som passar din sajt bäst.

1. Shortcodes

Enklaste sättet. Fungerar i alla teman och sidbyggare. Lägg in en shortcode på valfri sida.

• [pnty_jobs_table] — tabell med aktiva annonser
• [pnty_jobs_list] — lista med aktiva annonser
• [pnty_showcase_table] — tabell med referensannonser
• [pnty_showcase_list] — lista med referensannonser

Gemensamma attribut (alla shortcodes):

Attribut	Beskrivning	Standard
tag	Filtrera på tagg(ar), separerade med |
numberposts	Max antal annonser	-1 (alla)
organization_name	Visa organisationsnamn	0
location	Visa plats	0
region	Visa region	0
empty_msg	Meddelande när inga annonser finns
class	CSS-klass för wrapper-elementet

Tabell-attribut (pnty_jobs_table, pnty_showcase_table):

Attribut	Beskrivning	Standard
title_column_name	Rubrik för titelkolumnen	Title
publish_date	Visa publiceringsdatum	1
link_all	Gör alla celler klickbara	0
excerpt_title	Visa utdrag som tooltip vid hover	0

List-attribut (pnty_jobs_list, pnty_showcase_list):

Attribut	Beskrivning	Standard
logo	Visa organisationslogotyp	0
logo_width	Logotypbredd i pixlar
excerpt	Visa utdrag	0
readmore	Visa en läs-mer-länk med angiven text

2. Elementor Dynamic Tags

Om sajten använder Elementor kan du bygga en helt egen annonsmall. Pluginet registrerar Dynamic Tags som kan bindas till Elementor-widgets.

Så här gör du:

1. Gå till Templates → Theme Builder i Elementor
2. Skapa en ny Single Post-template
3. Välj att den ska gälla för posttypen pnty_job
4. Dra in widgets (Text, Image, etc.) och klicka på skiftnyckel-ikonen (Dynamic Tags) för att binda dem till Ponty-fält

Bild-taggar (för Image-widgets):

Dynamic Tag	Beskrivning
Ponty Logo	Organisationens logotyp
Ponty Profile Image	Kontaktpersonens profilbild

Text-taggar (för Text Editor, Heading, etc.):

Dynamic Tag	Beskrivning
Ponty Location	Arbetsort
Ponty Region	Region
Ponty Organization Name	Organisationsnamn
Ponty Contact Name	Kontaktpersonens namn
Ponty Contact Title	Kontaktpersonens titel
Ponty Phone	Telefonnummer
Ponty Email	E-postadress
Ponty Withdrawal Date	Avpubliceringsdatum
Ponty External Apply URL	Extern ansökningslänk
Ponty Video URL	Video-URL
Ponty Language	Annonsens språk

Tips: Om du bygger en egen Elementor-template bör du stänga av "Visa kundlogotyp i annons" och sätta ansökningsknappen till "Visa inte" i pluginets inställningar, annars visas de dubbelt.

3. Gutenberg Block Bindings

Från WordPress 6.5+ med ett block-tema kan du bygga annonsmallar direkt i Site Editor utan Elementor.

Så här gör du:

1. Gå till Utseende → Redigerare → Mallar
2. Skapa en ny mall för posttypen pnty_job
3. Lägg in block (Paragraph, Image, Button, etc.)
4. Bind block-attribut till Ponty-fält via Block Bindings med källan pnty/fields

Exempel: Ett stycke som visar arbetsort:

<!-- wp:paragraph {
    "metadata":{
        "bindings":{
            "content":{
                "source":"pnty/fields",
                "args":{"key":"_pnty_location"}
            }
        }
    }
} -->
<p></p>
<!-- /wp:paragraph -->

Exempel: En bild som visar organisationens logotyp:

<!-- wp:image {
    "metadata":{
        "bindings":{
            "url":{
                "source":"pnty/fields",
                "args":{"key":"_pnty_logo"}
            },
            "alt":{
                "source":"pnty/fields",
                "args":{"key":"_pnty_logo"}
            }
        }
    }
} -->
<figure class="wp-block-image">
    <img src="" alt=""/>
</figure>
<!-- /wp:image -->

Tillgängliga nycklar — se Metafält nedan.

Tips: Samma som för Elementor — stäng av logotyp och ansökningsknapp i inställningarna om du visar dem via block bindings.

4. PHP-template

Mest kontroll. Skapa filen single-pnty_job.php i din temamapp (eller single-pnty_job_showcase.php för referensannonser). WordPress använder den automatiskt.

Grundläggande exempel:

<?php get_header(); ?>
<?php if (have_posts()): while(have_posts()): the_post();?>
    <div class="pnty-job">
        <h1><?php the_title();?></h1>
        <?php the_content();?>
    </div>
<?php endwhile; endif;?>
<?php get_footer(); ?>

Exempel med metadata:

<?php get_header(); ?>
<?php if (have_posts()): while(have_posts()): the_post();
    $location = get_post_meta(get_the_ID(), '_pnty_location', true);
    $org      = get_post_meta(get_the_ID(), '_pnty_organization_name', true);
    $logo_id  = get_post_meta(get_the_ID(), '_pnty_logo_attachment_id', true);
?>
    <div class="pnty-job">
        <?php if ($logo_id): ?>
            <?php echo wp_get_attachment_image($logo_id, 'pnty_logo'); ?>
        <?php endif; ?>
        <h1><?php the_title();?></h1>
        <?php if ($org): ?>
            <p class="org"><?php echo esc_html($org); ?></p>
        <?php endif; ?>
        <?php if ($location): ?>
            <p class="location"><?php echo esc_html($location); ?></p>
        <?php endif; ?>
        <?php the_content();?>
    </div>
<?php endwhile; endif;?>
<?php get_footer(); ?>

Hämta annonser med viss tagg:

<?php
    $jobs = get_posts([
        'post_type' => 'pnty_job',
        'has_password' => false,
        'numberposts' => -1,
        'tax_query' => [[
            'taxonomy' => 'pnty_job_tag',
            'field'    => 'slug',
            'terms'    => 'exempeltagg'
        ]]
    ]);
?>
<?php if (count($jobs) > 0):?>
    <ul>
        <?php foreach($jobs as $job):?>
            <li>
                <a href="<?php echo get_permalink($job->ID);?>">
                    <?php echo esc_html($job->post_title);?>
                </a>
            </li>
        <?php endforeach;?>
    </ul>
<?php else:?>
    <p>Det finns inga publicerade annonser just nu.</p>
<?php endif;?>

Spontanansökan

Shortcoden [pnty_apply_btn] renderar en ansökningsknapp som kan användas för spontanansökningar eller kopplas till ett specifikt uppdrag.

[pnty_apply_btn
    org="exempelorg"
    assignment_id="12345"
    title="Ansök här"
    color="#e3304c"
    lang="sv"
]

org (obligatorisk)

Underdomänen för Ponty-systemet, t.ex. mittforetag

assignment_id (obligatorisk)

Uppdragets ID i Ponty

title

Knapptext. Standard: "Ansök här"

color

Hexadecimal färgkod för knappen

lang

Språkkod, t.ex. sv eller en

Metafält

Varje annons har följande metadata som kan användas i templates, block bindings och Elementor. Alla är tillgängliga via get_post_meta() och via REST API:et.

Nyckel	Beskrivning
_pnty_assignment_id	Unikt ID från Ponty
_pnty_organization_name	Organisationsnamn
_pnty_location	Arbetsort
_pnty_region	Region
_pnty_name	Kontaktpersonens namn
_pnty_user_title	Kontaktpersonens titel
_pnty_email	Kontaktpersonens e-post
_pnty_phone	Kontaktpersonens telefon
_pnty_user_profile_image	URL till kontaktpersonens profilbild
_pnty_logo	URL till organisationens logotyp
_pnty_logo_attachment_id	WordPress attachment-ID för logotypen
_pnty_withdrawal_date	Avpubliceringsdatum
_pnty_external_apply_url	Extern ansökningslänk
_pnty_video_url	Video-URL
_pnty_language	Annonsens språk
_pnty_confidential	Om annonsen är konfidentiell
_pnty_address	Adress (JSON)
_pnty_client_contact	Kontaktuppgifter slutkund (JSON)
_pnty_meta_description	SEO-beskrivning

REST API

Alla annonser och metadata exponeras via WordPress REST API:

GET /wp-json/wp/v2/jobs
GET /wp-json/wp/v2/jobs/{id}
GET /wp-json/wp/v2/showcase-jobs
GET /wp-json/wp/v2/showcase-jobs/{id}

Metafälten ovan finns i meta-objektet i svaret. Läsning kräver ingen autentisering.

Action hooks

Två hooks finns för egen vidare bearbetning:

pnty_action_post_job

Körs efter att en annons skapats eller uppdaterats. Argument: dataobjektet från Ponty.

pnty_action_delete_job

Körs efter att en annons raderats. Argument: assignment_id.

FAQ

Jag har matat in API-nyckeln men ser inga annonser?

Pluginet hämtar aldrig data — det tar bara emot. Publicera en annons i Ponty-systemet så skickas den automatiskt.

Logotypen visas dubbelt?

Det händer om du visar logotypen både via en egen template (Elementor/Gutenberg) och via pluginets inbyggda content-filter. Stäng av "Visa kundlogotyp i annons" i inställningarna.

Kan jag använda pluginet utan Elementor?

Ja. Shortcodes fungerar i alla teman. Med WordPress 6.5+ och ett block-tema kan du använda Gutenberg Block Bindings. Du kan också skriva en egen PHP-template.

Hur filtrerar jag annonser på tagg?

I shortcodes: tag="min-tagg". I PHP: använd tax_query med taxonomin pnty_job_tag.

Var hittar jag attribut-dokumentationen för shortcodes?

Under Inställningar → Ponty Connector → Dokumentation i WordPress-admin.

Changelog