opCREDITCARD – WordPress plugins

opCREDITCARD v1.1 – Kreditkortbetaling via epay.dk’s betalingsgateway

Forudsætninger og muligheder

• Du er nødt til at blive kunde hos epay.dk og oprette en konto hos dem
• Du skal have en WordPress blog minimum version 2.3.1
• PHP på dit webhotel må IKKE køre med safe_mode
• Understøttede kreditkort er: Dankort, VisaDankort, eDankort
• Velegnet til salg af få produkter eksempelvis services eller software
• Der genereres en PDF faktura, som kan downloades af køber efter betaling, og som også sendes til køber via e-mail
• Hvis du vil lave om i designet må du (desværre) have fat i en programmør. Bemærk at alt styling endnu ikke er blevet placeret i en ekstern CSS fil (beklager)

Licens of ansvarsfraskrivelse

opCREDITCARD benyttes på eget ansvar, OP.dk kan ikke gøres ansvarlig for misbrug eller forkert brug af dette plugin.

opCREDITCARD må benyttes og distributeres under GNU General Public License. Licensteksten (engelsk) kan læses i tekstfilen license.txt license.txt som også følger og altid skal føgle med en opCREDITCARD distributionen

Installationsvejledning

• Download opCREDITCARD v1.1 zip fil, udpak zip filen og upload den via FTP til /wp-content/plugins
• På et Linux baseret webhotel skal du gøre folderen /wp-content/plugins/opcreditcard/doc skrivbar (chmod 777 doc)
• I toppen af filen opcreditcard.php skal du tilpasse følgende indstillinger:
  • OP_CREDITCARD_ROOT_PATH
  • OP_CREDITCARD_PLUGIN_URL
  • OP_CREDITCARD_PDF_INVOICE_PATH
  • OP_CREDITCARD_DOMAIN
  • OP_CREDITCARD_HTTP_DOMAIN
  • OP_CREDITCARD_TERMSCONDITIONS_URL
  • OP_CREDITCARD_STEP_1_URL
  • OP_CREDITCARD_STEP_2_URL
  • OP_CREDITCARD_STEP_3_URL
  • OP_CREDITCARD_STEP_4_URL
  • OP_CREDITCARD_ACCEPT_URL
  • OP_CREDITCARD_DECLINE_URL
  • OP_CREDITCARD_CALLBACK_URL
  • OP_CREDITCARD_PREANALYSIS_STEP_1_URL (Skal tilpasses efter dine produkter. Husk også at tilpasse metoderne getStep1Url() og opCreditCardReplacer() længere nede i samme fil)
  • OP_CREDITCARD_MERCHANT_NUMBER (epay.dk “kundenummer”)
  • OP_CREDITCARD_SYSTEM_ADMINISTRATOR_EMAIL
  • OP_CREDITCARD_SEND_COPY_OF_EMAIL_CONFIRMATION_TO
  • OP_CREDITCARD_CURRENCY_CODE (epay.dk valuta betalingskode)
  • OP_CREDITCARD_DEFAULT_CARD_TYPE (epay.dk tillladte korttyper)
  • OP_CREDITCARD_COMMON_COMMON_MD5_KEY (epay.dk MD5 baseret krypteringsnøgle)
  • OP_CREDITCARD_SYSTEM_DEBUG_EMAIL

   

• I toppen af filen opcreditcard.php skal du tilpasse følgende indstillinger:
  • FPDF_PATH
  • OP_CREDITCARD_ROOT_PATH (samme værdi som ovenfor)
  • OP_CREDITCARD_PLUGIN_URL (samme værdi som ovenfor)
  • OP_CREDITCARD_TRANSLATION_FILE (samme værdi som ovenfor)
  • LOGO_FILE
  • LOGO_WIDTH
  • LOGO_HEIGHT

   

• I filen translations.txt kan du oversætte hele brugergænsefladen til flere sprog eller eksempelvis tilpasse teksten til den PDF faktura som systemet automatisk genererer. Bemærk at systemet som default er sat op til at vise dansk.
• Oprettelse af produkter er desværre bøvlet og sker ved at slette (vores) produkter fra methoden reference_getAvailableProducts() inde i filen opcreditcard.php.

// Produkt 1: Podcast om indpakning af julegaver
if ($ displayProductSku_S == "all" || $ displayProductSku_S == "din-interne-produkt-id") {
	$ productSet_Ar = null;
	$ productSet_Ar[$ typeHash_S] = "Kategori";
	$ productSet_Ar[$ skuHash_S] = "Produktnummer";
	$ productSet_Ar[$ nameHash_S] = "Produktnavn";
	$ productSet_Ar[$ descriptionHash_S] = "Produktbeskrivelse";
	$ productSet_Ar[$ priceHash_S] = (float) 4950.0; // Pris uden moms
	$ productSet_Ar[$ logoHash_S] = "/wp-content/themes/wp-andreas01/img/betalt-optagelse.png"; // Placering af produktbillede
	$ productSet_Ar[$ urlHash_S] = "/url-til-side-der-beskriver-produktet";
	$ products_Ar[] = $ productSet_Ar;
}

• Ændring af valuta symbol (hvis anden møntfod end DKK) ændret i filen opcreditcard.php, du skal lede efter følgende PHP kode:

$ currencySymbol_S = "DKK";

• Gå ind i WordPress’ kontrolpanelet og aktiver plugin
• Tilgå MySQL databasen via dit webhotels kontrolpanel eller lignende
  • Find den tabel der hedder (typisk) wp_opcreditcard
  • Indsæt manuelt den første linie i denne tabel, de eneste data du skal indtaste er de fakturanummer du ønsker at starte med i feltet ‘invoiceNumber’

   

• Du skal oprette mindst 7 nye sider (ikke blogindlæg) i WordPress. Sidernes URL’er skal svære til de værdier du har indtastet for (se ovenfor)
  • Trin 1: OP_CREDITCARD_STEP_1_URL
  • Trin 2: OP_CREDITCARD_STEP_2_URL
  • Trin 3: OP_CREDITCARD_STEP_3_URL
  • Trin 4: OP_CREDITCARD_STEP_4_URL
  • Trin 5(a): OP_CREDITCARD_ACCEPT_URL
  • Trin 5(b): OP_CREDITCARD_DECLINE_URL
  • Trin 6: OP_CREDITCARD_CALLBACK_URL

   

  På disse sider skal du indsætte følgende koder:

  • Trin 1 (Alle produkter):
    ¦opcreditcard:stepBar1¦
    <h1>Bestil produkter – Trin 1 af 5</h1>
    ¦opcreditcard:orderProducts-all¦

     

  • Trin 1 (Et produkt vises, ikke obligatorisk at opsætte):
    ¦opcreditcard:stepBar1¦
    <h1>Bestil SEO foranalyse – Trin 1 af 5</h1>
    ¦opcreditcard:orderProducts-seopreanalysis¦

     

  • Trin 2:
    ¦opcreditcard:stepBar2¦
    <h1>Leveringsoplysninger – Trin 2 af 5</h1>
    ¦opcreditcard:deliveryInformation¦

     

  • Trin 3:
    ¦opcreditcard:stepBar3¦
    <h1>Godkend oplysninger – Trin 3 af 5</h1>
    ¦opcreditcard:confirmInformation¦

     

  • Trin 4:
    ¦opcreditcard:stepBar4¦
    <h1>Betaling – Trin 4 af 5</h1>
    ¦opcreditcard:ePayPaymentUrl¦

     

  • Trin 5 (Ordrebekræftelse):
    ¦opcreditcard:stepBar5¦
    <h1>Ordrebekræftelse – Trin 5 af 5</h1>
    ¦opcreditcard:ePayAcceptUrl¦

     

  • Trin 5 (Fejl):
    ¦opcreditcard:stepBar5¦
    <h1>Fejl ved betaling – Trin 5 af 5</h1>
    ¦opcreditcard:ePayDeclineUrl¦

     

  • Trin 6 (Callback fra epay.dk, skjult for brugeren)
    <h1>Afslut ordre</h1>
    ¦opcreditcard:ePayCallBackUrl¦

     

/Grosen Friis, OP.dk 08/04-2009