CSV to html

Installation

Den här avdelningen beskriver hur du installerar pluginet och hur du får det att fungera.

Titta på inspirerande exempel på vad du kan göra med plugin här: http://wibergsweb.se/plugins/csvtohtml/

Men FÖRST, gå igenom stegen nedan!

STEG 1 – INSTALLATION
1. Ladda upp plugin-mappen csvtohtml till `/wp-content/plugins/’-katalogen, eller installera plugin-programmet direkt via WordPress-plugin-skärmen.
2. Aktivera plugin-programmet via skärmen ’Plugins’ i WordPress

STEG 2 – FÖRBEREDELSER
Insticksprogrammet kan antingen hämta filer lokalt från din server (eller från en extern resurs). Insticksprogrammet stöder csv-filer, Excel (endast xlsx-filer), ods-filer (kalkylblad) och json-filer. Om du använder en json-fil bör du ställa in källtyp till JSON. I de flesta fall bör källtypen ställas in för att gissa om den inte använder JSON.

Lokal hämtning

1. Skapa en mapp som heter csvtohtmlfiles i ditt wp-content/uploads/ manuellt (t.ex. wp-content/uploads/csvtohtmlfiles bör skapas)
2. Ladda upp/kopiera din fil till denna skapade mapp (t.ex. wp-content/uploads/csvtohtmlfiles/testfile.csv). Detta kan inte göras från mediauppladdning (Använd ftp, ssh eller direkt på ditt OS för att kopiera filer till webbservern).

Extern hämtning

1. Ha en uri till din csv-fil tillgänglig/tillgänglig från din dator (t.ex. https://[domän]/testfil.csv).

STEG 3 – KORTKODSGENERATOR
1. Börja förstå vad du kan göra med plugin-programmet. Gör detta genom att leka med kortkodsgeneratorn CSV till HTML. Detta är tillgängligt i administratörsinstrumentpanelen – Verktyg/CSV till HTML. Gör detta på en stationär dator för enklast hantering.
2. Försök och klicka/ändra inställningar och se förhandsgranskningen av tabellen till höger. Den här förhandsvisningen visar bara hur det skulle se ut, men funktionalitet som sökning och sidnumrering etc kommer inte att fungera.
3. Om du vill se den aktuella utdata baserat på tillämpade inställningar, bör du klicka på knappen uppdatera/förhandsgranska -.
4. Inställningarna är uppdelade i olika sektioner på kortkodsgeneratorsidan.
5. Avsnittet "Felsökning" visar kända fel och ger varningar beroende på dina inställningar. Den blir röd när det finns några fel eller varningar. Detta betyder inte nödvändigtvis att det inte kommer att fungera men kan vara en indikator på något du måste justera.
6. Du bör se "Allmänt" avsnittet som utgångspunkt för dina inställningar. Som standard används alla csv-filer som finns i wp-content/uploads för att generera en tabell (*.csv).
7. Ändra *.csv till namnet på filen du förberedde i STEG2.

Lokal hämtning

1. Ange sökväg (lokal) till csvtohtmlfiler eller klicka på knappen med tre punkter och välj csvtohtmlfiler (om du har gjort tidigare steg bör du se din mapp csvtohtmlfiler här). I fil(er) kombinerat med den här tabellen skriver du filen som du lägger in i wp-content/uploads/csvtohtmlfiles
2. Om en Excel-fil väljs för hämtning, konverteras den till en csv-fil och Excel-filen förblir intakt (så det finns två filer som har identiska data i samma mapp). Detta kan tyckas överflödigt, men det beror på att plugin-programmet hämtar data från csv-filen och inte från Excel-filen direkt.

Extern hämtning

1. I fil(er) kombinerat med den här tabellen lägg in din webbadress som du förberedde i STEG2. Om din externa fil är ett google-kalkylblad, se till att den är offentligt tillgänglig för nedladdning och att du har hela uri till din googlesheets-arbetsbok. Ställ även in "lägg till tillägg automatiskt" till nr.
2. Om du har fler filer du vill kombinera, lägg bara till ett semikolon (;) och lägg till filnamn (lokalt eller externt)

STEG 4 – FÅ DET ATT FUNKA
10. Lek med inställningarna tills du är nöjd. I väldigt få fall bör du ändra teckenkodningar men om du har problem med kodningen kan du försöka ändra dessa inställningar.
11. Kopiera genererad kortkod (ovanför avsnittet Allmänt) och lägg in kortkoden i en wordpress-sida eller inlägg för att visa tabell med den funktionalitet du har ställt in på sidan för kortkodsgenerator.
12. Om du inte gillar standarddesignen för tabellen/tabellerna, använd ditt temas css för att ändra layouten på din webbplats/tabell etc.

Om du har problem som du inte kan lösa vänligen skicka ett mail till info@wibergsweb.se.
Om du gillar plugin, vänligen överväg att donera. Donera gärna till paypal info@wibergsweb.se. Beloppet spelar ingen roll. Jag tycker om kaffe! 🙂

KORTKOD
Om du känner dig bekväm genom att ändra inställningarna direkt i din kortkod: Nedan finns tillgängliga inställningar och vad de är avsedda för. Värde inom parentes visar standardvärdet för inställningen, så om den inställningen/attributet inte ingår i kortkoden kommer standardvärdet för inställningen att tillämpas.
Kortkoden ska alltid börja med [csvtohtml_create följt av inställningar/attribut nedan. Varje inställning måste ha ett mellanslag mellan och ] måste ställas in i slutet av kortkoden.

Ett annat alternativ är att gå in i kortkodsgeneratorn igen och upprepa föregående steg (från STEG2).

KORTKODSINSTÄLLNINGAR/ATRIBUT

add_ext_auto (ja) – Lägg till filtillägget .csv till filen (om det inte är specificerat i källfilerna). Ställ in på nej om du inte vill att ett filtillägg ska läggas till automatiskt. En vanlig användning för detta är att ställa in den här inställningen till no , så att Google-dokument kan nås (de har inte .csv i slutet).

api_cdn (ja) – (Gäller vid hämtning av json) Sätt detta till nej om du vill använda wordpress api (wordpress core api kan misslyckas med cloudflare av okänd anledning)

redigerbar (nej)– ja/nej – Standard är nej. Om inställd på ja-fil(er) kan den inloggade användaren redigera värden direkt i tabellen (genom att ändra värden i inmatningsfälten) om han är inloggad. Vissa attribut är tillfälligt inaktiverade vid redigering men när de är inställda på nej eller utloggade, dessa attributen återställs.

convert_encoding_from – När du konverterar teckenkodning, definiera vilken nuvarande teckenkodning den csv-filen har. (Krävs inte och använd endast när du har problem med kodning)

convert_encoding_to – När du konverterar teckenkodning, definiera vilken teckenkodning som csv:n ska kodas till. (Krävs inte och använd endast när du har problem med kodning)

css_max_width (760) – mediefråga css-regler/brytpunkt. Detta tillämpas endast när responsiv är inställd på ja.

css_min_devicewidth (768) – mediefråga css-regler/brytpunkt. Detta tillämpas endast när responsiv är inställd på ja.

css_max_devicewidth (1024) – mediefråga css-regler/brytpunkt. Detta tillämpas endast när responsiv är inställd på ja.

csv_delimiter (,) – vilken avgränsare som ska användas i varje rad i csv (komma, semikolon etc)

debug_mode (nej) – Om inställt på yes kommer rubrikvärden och radvärden att matas ut till skärmen och filer som "filen hittades inte" kommer att visas (annars skulle det vara "tysta fel")

design_template – Vilken mall från inbyggda mallar som ska användas i tabellen. Möjliga värden är: nolines, clean, funky, thick, pyjamas, pyjamascols, thinlines

nedladdningsbart (nej) – Om inställt på ja, visas en knapp som skapar en nedladdning av en csv

nedladdningsbart_filnamn (export_csvtohtml.csv) – Vilket filnamn som ska användas vid nedladdning

nedladdningsbar_text (ladda ner som csv) – Vilken text som ska visas på nedladdningsbar knapp

eol_detection (cr/lf) – CR = Vagnretur, LF = Radmatning, CR/LF = Vagnslinje och radmatning, auto = autodetektering. Används endast för externa filer. När du använder lokala filer upptäcks nya rader automatiskt.

exclude_cols – Vilka kolumner som ska uteslutas i den slutliga HTML-tabellen (1,2,3,10-15 skulle utesluta kolumnerna 1,2,3,10,11,12,13,14 och 15). Om du vill ta bort den sista kolumnen, skriv helt enkelt sist istället för att ange ett nummer.

fetch_interval – Ställ in på dagligen, varje timme eller veckovis. Detta är hur ofta den faktiska hämtningen från källan görs. Det görs bara när du begär sidan med denna kortkod på. Detta skulle vara vettigt att använda för externa filer även om det är möjligt att använda med lokala filer också. För att detta ska fungera måste du ange ett html_id!

fetch_lastheaders (0) – Antal specifika rubriker (t.ex. kolumner) att hämta (från slutet)

filter_data – Vilken data som ska filtreras i tabellen (specifik sträng), t.ex. FSC

filter_data_ucfirst (nej) – Om inställningen är ja, kommer första bokstaven att vara versal (gäller endast a-z)

filter_operator (lika med) – Berätta hur du använder filtret
mellan >= värde1 och <= värde2
är lika med (=)
equals_caseinsensitive (likar med skiftlägesokänsligt filter
urlequals är lika med skiftlägesokänslig och sök både med hypen/mellanslag och understreck
mindre <
lika <=
mer >
mequal >=
jokertecken någon
nydatum från ett specifikt datum eller från dagens datum

filter_removechars – Om du har fler tecken än bara siffror i (cell)värdena, ta bort det/dessa tecken så att jämförelsen endast kommer att göras för siffror (t.ex. 567 kommer att användas för jämförelse om $567 visas)

filter_col– Vilken kolumn ska filtret användas på (endast EN kolumn)

float_divider (.) – Om du hämtar float-värden från csv använd detta tecken för att visa ett annat "float-divider-tecken" än punkt (t.ex. 6,3 istället för 6,3, 1,2 istället för 1,2 etc)

groupby_col – Gruppera efter en kolumn (t.ex. om olika företag är listade i den kolumnen, kommer gruppering att göras för företag)

groupby_col_header (ja) – Om du använder groupby_col och detta är inställt på yes, visa rubriker på en rad innan alla rader för detta grupperade värde visas

headerrows_start – Vilken rad i filen som rubriker kommer att genereras från

html_id – ange id för denna tabell

html_class – ange klass för denna tabell (förutom standard csvtohtml – klass)

hidetable_load (nej) – Dölj tabell vid sidladdning om inställt på Ja

hidetable_reset (nej) – Dölj tabell när du klickar på återställningsknappen om den är inställd på yes (annars visas hela tabellen även om hidetable_load är inställd)

htmltags_autoconvert (nej) – Ställ in på ja om du vill (auto)konvertera länkar till html-länkar (<a>), bilder till <img> och skicka till "maillänkar" (länk med mailto:).

htmltags_autoconvert_imagealt (tom sträng) – Ställ in alt-text för alla bilder ELLER baserat på ett specifikt kolumnvärde (t.ex. om det är inställt på 2, hämta värdet från den andra kolumnen för samma rad som bilden är på)

htmltags_autoconvert_newwindow (nej) – Om vanliga länkar, öppna dem i ett nytt fönster. Det här attributet har endast effekt när htmltags_autoconvert är inställt på yes

include_cols – Vilka kolumner som ska inkluderas i den slutliga HTML-tabellen (1,2,3,10-15 skulle visa kolumn 1,2,3,10,11,12,13,14 och 15). Om include_cols anges ignoreras exclude_cols.

inkludera_rader – Vilka rader som ska inkluderas i den slutliga HTML-tabellen (1,2,3,10-15 skulle visa rad 1,2,3,10,11,12,13,14 och 15).

json_startlevel – När man använder json som source_type skulle plugin-programmet hämta data från första nivån i json-hierarkin

notfound_message (no) – Vilket meddelande som ska visas när sökresultatet inte hittas. (search_functionality måste vara inställt på Ja för att det här alternativet ska vara giltigt)

paginering (nej) – Anger om paginering ska användas eller inte (ja/nej). Standard är nej.

pagetion_above_table (nej) – Visa paginering ovanför tabellen. Paginering måste ställas in på ja för att detta ska fungera.

pagetion_below_table (ja) – Visa paginering under tabellen. Paginering måste ställas in på ja för att detta ska fungera.

pagination_links_max (10) – Visa länkar (1,2,3… upp till 10 länkar som standard). Sätt till 0 om du inte vill visa dessa länkar alls.

pagineringsrader (10) – Antal rader som ska visas för varje sidnumrering.

paginering_start (1) – rad att starta sidnumrering med (vanligtvis alltid 1)

paginering_text_sista (Sista) – Text sist för paginering. Ställ in på "" om du inte vill visa (om paginering är inställt på ja).

pagination_text_next (Nästa) – Text Next för paginering. Ställ in på "" om du inte vill visa (om paginering är inställt på ja).

paginering_text_föregående (föregående) – Föregående text (föregående) för sidnumrering. Ställ in på "" om du inte vill visa (om paginering är inställt på ja).

pagination_text_start (Start) – Textstart för sidnumrering. Ställ in på "" om du inte vill visa (om paginering är inställt på ja).

sökväg – relativ sökväg till uploads-mappen för wordpress – installation (t.ex. /wp-content/uploads/{sökväg}). Gäller lokala filer.

resetbutton_text (Reset) – Återställ knapptext (search_functionality måste vara inställd på yes för att det här alternativet ska vara giltigt)

responsiv (ja) – ja/nej – Standardinställningen är ja, men detta kan ställas in på nej om du har problem med annan css på din webbplats.

return_rader_array (nej) – ja/nej. Användbart om du skapar egen kod och bara vill hämta data.

search_exactmatch (no) Använd exakt matchning för sökning (t.ex. Great hämtar värden som Great, not Great Britain)

search_caseinsensitive (ja) Använd skiftlägesokänslig (t.ex. Bra och bra avkastning Bra eller bra vid sökning)

search_cols – Vilka kolumner du ska söka i när du använder sökfunktioner. Inkludera och exkludera kolumn ignoreras när du använder denna inställning/attribut. Om inget värde ges till detta attribut/inställning – söks alla kolumner.

search_functionality (nej) – Gör tabelldata sökbar (ett sökinmatningsfält, en sökknapp och en återställningsknapp visas).

searchbutton_text (Search) – Sökknapptext (search_functionality måste vara inställd på Ja för att det här alternativet ska vara giltigt)

searchinput_placeholder (tom sträng) – Platshållare för sökinmatningsfält. Standard är tom.

search_requiredchars (0) – Hur många tecken som krävs när du gör en sökning. Standard 0 säger att det inte finns några krav.

search_requiredchars_message (tom sträng) – Meddelande till användaren om tecken som inte krävs är giltiga vid sökning. Om detta inte är inställt visas ett standardmeddelande.

search_realtime (nej) – Ställ in på ja om du vill att systemet ska söka utan att trycka på någon knapp (efter att användaren skrivit några tecken). Det är en fördröjning på cirka 1 sekund efter att användaren har börjat skriva

sort_cols – Vilken/vilka kolumner som ska sorteras i format nr,nr och nr-nr (exempel 1,2,4 eller 1-2,4)

sort_cols_order (asc) – Vilken ordning att sortera kolumner på (asc/desc). Om du har 3 kolumner kan du definiera dessa med olika sortering som asc,desc,asc

sort_cols_userclick – Sort_cols måste ställas in. om detta är inställt på dig kan användaren klicka för att sortera en specifik kolumn. Detta åsidosätter sort_cols_order efter första klick

sort_cols_userclick_arrows – sort_cols_userclick måste ställas in. Pilar visas i rubrikkolumner med stigande eller fallande ordning.

källa_filer – fil(er) som ska inkluderas. Om du använder mer än en fil – separera dem med semikolon (;). Det är möjligt att inkludera en fullständig url istället för ett filnamn för att hämta externa csv-filer. Det är också möjligt att hämta filer från en given sökväg (med till exempel *.csv).

källa_typ (visualizer_plugin) – vilken typ som ska användas för att identifiera innehåll i csv-filer (giltiga typer är gissning och visualizer_plugin). Om du är osäker på vad du ska ställa in, ställ in "gissa" här.

tabell_i_cell_kolumner – Du kan välja att ha extra data i en tabell i en cell från specifika kolumner (samma format som include_cols). exclude_cols ignoreras om detta används. Detta kan vara användbart om du vill göra en svävningseffekt för att visa lite extra data.

table_in_cell_header (Mer data) – Kolumnnamn för tillagd data, om table_in_cell_cols har angetts och table_in_cell_header inte är standardvärdet: "Mer data"

table_in_cell_wrapperclass – Klass för div som omger tabell inuti cellen när du använder table_in_cell_cols

titel – ange titel som visas som text i det övre vänstra hörnet av html-tabellen (om inte angivet – ingenting visas)

total_procent_above_table (ja) – Visa den totala procentandelen av ett specifikt värde ovanför tabellen. Ignoreras om total_percentage_chechkvalue och total_percentage_col inte är inställda.

total_percentage_below_table (nej) – Visa den totala procentandelen av ett specifikt värde under tabellen. Ignoreras om total_percentage_chechkvalue och total_percentage_col inte är inställda.

total_percentage_checkvalue – Kontrollera procentandelen av ett specifikt värde i en specifik kolumn. totals_pecentage_col måste anges.

total_percentage_col – Vilken kolumn du ska checka in. total_percentage_chechkvalue måste anges för att detta ska fungera

total_percentage_text – Define what text to say when using total_percentage_checkvalue. If not defined it will only show percentage value followed by %

total_percentage_decimals (0) – Antal decimaler som ska visas när den totala procentandelen visas

totals_cols_bottom – Add totals with given columns at bottom of table (example 1,2,4 or 1-2,4)

totals_cols_bottom_empty – Vilken sträng/tecken som ska visas när det inte finns någon beräkning

totals_cols_bottom_title – Ange en specifik sträng när totalsummor läggs till (återsätter totalvärde och totals_cols_bottom_empty)

totals_cols_bottom_title_col – Vilken kolumn ska denna specifika titel ställas in på

totals_cols_prefix (tom sträng) – Lägg till prefix till den totala kolumnen (t.ex. 10 USD)

totals_cols_suffix (tom sträng) – Lägg till suffix till den totala kolumnen (t.ex. 10$)

SPECIELLA VARIABLER/TECKEN
användning för filterdata: %urlparts-X där X anger sökvägsnivå (t.ex. om %urlparts-2 sökväg skulle vara site/path1/path2).

användning för sökväg: Om %userlogin% anges någonstans i sökväg, ersätt det med det faktiska användarnamnet för den inloggade användaren (t.ex. csvtohtmlfiles/%userlogin% skulle ladda olika filer baserat på vilken användare som är inloggad)

användning för att ange fil (lokala filer): Jokertecken för filsökning med * (t.ex. beliver*.csv skulle inkludera alla csv-filer som började med beliver i sitt filnamn)

Titta på inspirerande exempel på vad du kan göra med plugin här: http://wibergsweb.se/plugins/csvtohtml/

Om du har problem som du inte kan lösa vänligen skicka ett mail till info@wibergsweb.se.

Om du gillar plugin, vänligen överväg att donera. Donera gärna till paypal info@wibergsweb.se. Beloppet spelar ingen roll. Jag tycker om kaffe! 🙂