Ponty logo

connector

Looking for an english version?

För annonspublicering i en WordPress-installation används vårt plugin Ponty Connector som kan hämtas här (37KB).

Vårt plugin gör i korthet två saker:

  1. Deklarerar två så kallade Custom Post Types (pnty_job, pnty_job_showcase)
  2. Tar emot data från vårt system på en särskild url

Följden av detta är att annonsdata, när det väl skickats från vårt system till WordPress-installationen, därefter kan hanteras som vilket WordPress-innehåll som helst.

Använda pluginet

Till pluginet finns ett par shortcodes som kan användas för att få en grundläggande funktionalitet på plats. Tillgängliga attribut för att styra vissa av shortcodens egenskaper finns dokumenterat på pluginets inställningssida. Även den meta-data som också finns tillgänglig för varje annons dokumenteras där.

FAQ

Jag har matat in API-nyckeln men ser inga annonser?
Pluginet hämtar aldrig data utan möjliggör bara mottagande. Ett Ponty-system måste skicka annonsdata för att det skall dyka upp i WordPress-installationen.

Vanliga ändringar

Den absolut vanligaste ändringen som görs för att få annonsvisningen att se bra ut är att skapa en ny fil i tema-mappen som heter single-pnty_job.php. Den filen ansvarar då för hur enskilda annonser visas på sajten. Ett väldigt grundläggande exempel visas nedan.

<?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(); ?>

Andra vanliga ändringar är att skriva egna metoder för visningen av alla eller utvalda annonser. Ett exempel följer nedan för visning av annonser som har en 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 class="exempel">
        <?php foreach($jobs as $job):?>
            <li>
                <a
                   href="<?php echo get_permalink($job->ID);?>"
                   title="Permalänk till <?php echo $job->post_title;?>"
                >
                  <?php echo $job->post_title;?>
                </a>
            </li>
        <?php endforeach;?>
    </ul>
<?php else:?>
    <p>Det finns inga publicerade annonser just nu.</p>
<?php endif;?>

Spontanansökningsknapp

Om man vill låta Ponty Connector rendera en spontanansökningsknapp kan man använda följande shortcode.

[pnty_apply_btn
    org="{exempelorg}"
    color="{hexadecimal färgkod}"
    assignment_id="{uppdragsid från Ponty}"
]

Både exempelorg och uppdragsid fås genom Ponty-systemet där exempelorg är den underdomän som aktuellt system körs på och uppdragsid hämtas från önskat uppdrag.

Changelog

1.0.13

2023-10-27

Stöd för PHP 8.x. Widget pnty_latest_jobs_widget är borttagen pga kompatibilitetsproblem. Meta-data för url till profilbild från Ponty finns i _pnty_user_profile_image om profilen har en uppladdad bild i Ponty.

1.0.12

2021-09-22

Attributet location kan nu användas för shortcode pnty_jobs_list och pnty_showcase_list.

1.0.11

2021-02-25

Två action hooks pnty_action_post_job och pnty_action_delete_job finns nu tillgängliga. Används om vidare processering utanför pluginet önskas.

1.0.10

2019-12-09

Pluginet kan nu ta emot en video-URL som finns tillgänglig som metadata med nyckel _pnty_video_url.

1.0.9

2019-10-31

Pluginet kan nu ta emot ett lösenord vilket gör att enskilda annonser kan skyddas. Syftet är att kunna "förhandsgranska" en annons. Tänk på att alla eget skrivna metoder som hämtar data bör ha 'has_password' => false.

1.0.8

2019-03-05

Beroendet på create_function har tagits bort för kompatibilitet med >= PHP 7.2.

1.0.7

2018-12-13

Buggfix. Shortcode-attributet logo_width skrevs felaktigt över.

1.0.6

2018-10-03

Metadatan _pnty_language finns nu tillgänglig.

1.0.5

2018-01-31

Buggfix för loggor som visades felaktigt i list-shortcode. Ett dokumentationsfel har också åtgärdats.

1.0.4

2017-09-25

Metadatan _pnty_confidential och _pnty_external_apply_url finns nu tillgänglig i egna fält. Den inbyggda list-shortcoden använder också lokalt uppladdade loggor i de fall sådana finns.

1.0.3

2017-06-16

Buggfix. Villkorssatsen för 1.0.2 skulle ha negerats.

1.0.2

2017-05-29

Förfrågningar mot webhooks-url:er sker bara när nya annonser publiceras. Referensannonser (pnty_jobs_showcase) undantas nu.

1.0.1

2017-05-22

Buggfix. En felsökningssträng för test av bakåtkompatibilitet låg kvar i koden.

1.0.0

2017-05-16

0.4.11

2017-04-11

Möjlighet att ange url:er för webhooks som triggas när ny annons publiceras.

0.4.10

2017-03-09

Uppdatering av annons rensar nu tidigare kopplade taggar.

0.4.9

2017-03-02

Buggfix. Meta-data för kontakt och adress lagrades inte konsekvent och som de JSON-strängar dokumentation hänvisar till.

0.4.8

2017-02-19

Möjlighet att ta emot en base64-kodad hero-bild. Om den skickas lagras den som meta-data till annonsen under nyckeln _pnty_hero_image.

0.4.7

2017-01-30

_pnty_withdrawal_date finns nu som meta-data till varje annons. Avser det datum som annonsen avpubliceras.

0.4.6

2016-12-13

Lagt till wp_reset_postdata(); efter varje get_posts-loop så att eventuella senare tema-funktioner beroende av globala variabler fungerar som de skall.

0.4.5

2016-12-06

Möjlighet att styra vilket meddelande som visas när inga annonser finns. Gäller för samtliga shortcodes genom attributet empty_msg.

0.4.4

2016-09-26

Löste en bugg som gjorde att rensning av tidigare skapad meta-data hindrade annonser från att publiceras.

0.4.3

2016-09-19

Städning/borttagning av annons-metadata tar inte längre bort data som ej skapats av vårt plugin.

0.4.2

2016-06-16

Möjlighet att via shortcode-attribut styra kolumnnamn för annonstitel-kolumn.

0.4.1

2016-06-12

Möjlighet att ta emot annonsdata som referenscase. Inkl nya shortcodes för att visa dem. Även dokumentationsförtydliganden på inställningssidan.

0.3.27

2016-03-16

Meta-data för kontaktuppgifter till ”slutkund” tillagt.

0.3.26

2016-02-18

Möjlighet att visa delningsknappar för sociala medier genom inställning.

0.3.25

2016-01-18

En widget för att visa jobb i lista i sidebar eller motsvarande har lagts till.

0.3.24

2015-12-22

Shortcoden pnty_jobs_table har nu stöd för attributet excerpt_title som kan ha värdet 1 eller 0. Används 1 kommer varje rad (<tr>) att få ett title-attribut med annonsens utdrag/excerpt.

0.3.23

Första publika versionen