CSV to html

Installation

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

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 ”Plugins”-skärmen i WordPress
3. Lägg shortcode på WordPress-inlägget eller sidan du vill visa det på och lägg till css för att ändra layout för dem.

Shortcodes

• [csvtohtml_create] – Skapa html-tabellen från specificerade csv-filer

[csvtohtml_create] attribut

• editable – yes/no – The default is no. If set to yes file(s) the logged in user may edit values directly in the table (through changing values in input-fields). Some attributes are temporarily disabled when editing but when set to no or logged out, these attributes are restored.
• responsive – yes/no – Standard är ”yes”, men denna kan sättas till ”no” om det uppstår problem eller om du vill göra helt egen css som styr responsivitet med din/dina tabeller.
• css_max_width – media query css regler/”breakpoints”. Den här inställningen har enbart någon effekt när responsive är satt till ”yes”.
• css_min_devicewidth – media query css regler/”breakpoints”. Den här inställningen har enbart någon effekt när responsive är satt till ”yes”.
• css_max_devicewidth – media query css regler/”breakpoints”. Den här inställningen har enbart någon effekt när responsive är satt till ”yes”.
• title – ange titel som visas som text i det övre vänstra hörnet av html-tabellen (annars visas ingenting där)
• html_id – sätt id för denna tabell
• html_class – anger klass för tabell (förutom standardklass för tabell som är csvtohtml)
• path – relativ väg utifrån uploads-mappen i WordPress-installationen (e.g. /wp-content/uploads/{path} )
• source_type – vilken typ för att identifiera innehåll i csv-filer (giltiga typer är guess och visualizer_plugin)
• fetch_lastheaders – Antal headers/kolumner att inkluder från slutet.
• source_files – Vilka filer som ska inkluderas. Om du vill inkludera mer än en fil så separerar dem med ett semicolon (;). Det är möjligt (från v1.0.2) att inkludera en url istället för ett filnamn för att hämta csv-fil(er) från extern(a) källa/källor. Det är också möjligt (v.1.1.36) att hämta filer från en specifik undermapp till uploads-mappen (med t.ex. *.csv)
• csv_delimiter – vilken avskiljare som används i csv-filen (komma, selikolon etc)
• exclude_cols – Vilka kolumner att exkludera i tabellen (1,2,310-15 skulle exkludera kolumnerna 1,2,3,10,11,12,13,14 och 15). Vill du ta bort sista kolumnen kan du skriva ”last” istället för ett specifikt nummer.
• include_cols – Vilken/vilka kolumner att inkludera i den slutgiltiga tabellen (1,2,3,10-15 visar colum 1,2,3,10,11,12,13,14 och 15). Om include_col är angiven, så kommer exclude_col att ignoreras.
• include_rows – Vilken/vilka rader att inkludera i den slutgiltiga htmltabellen (1,2,3,10-15 visar rad 1,2,3,10,11,12,13,14 och 15).
• table_in_cell_cols – Du kan välja att ha extra data i en tabellcell från specifika kolumn(er). Formatet är detsamma som t.ex. include_cols. Detta kan vara bra om du t.ex. vill ha en hover-effekt där du visar visst innehåll när du hovrar över en viss cell.
• table_in_cell_header – Namn på kolumn med tillagd data. Om table_in_cells är specificerat så är standardvärdet ”More data”
• table_in_cell_wrapperclass – Class för div som omsluter tabell inuti cell när man använder sig av table_in_cell_cols.
• filter_data – Vilken data som ska filtreras i tabellen (specifik sträng), e.g. FSC
• filter_data_ucfirst – Om inställt på ja, kommer första bokstaven att vara versal (gäller endast a-z)
• filter_operator – Talar om hur filtret ska appliceras (mellan (>= värde1 and <= värde2), lika med (=), urlequals(= små och stora bokstäver spelar ingen roll och – mellanslag och ”underscores”), mindre (<), mindre än eller lika med (<=) Mer (>), Mer eller lika med (>=) )
• filter_removechars – Om du har mer tecken än t.ex. siffror så kan du välja att ta bort dessa tecken så att enbart siffrorna finns kvar vid filtreringen.
• filter_col- Vilken kolumn att filtrera på (endast en kolumn)
• eol_detection – CR = Carriage return, LF = Line feed, CR/LF = Carriage line och line feed, auto = autodetect. Den här inställningen har enbart effekt på externa filer. Övriga filer tas hand om automatiskt.
• convert_encoding_from – När teckenkodningskonvertering sker, så definiera vilken teckenkodning som tecknen ska kodas från (Bästa resultat får man om man anger både encoding_from och encoding_to)
• convert_encoding_to – När teckenkodningskonvertering sker, så definiera vilken teckenkodning som tecknen ska kodas till (Bästa resultat får man om man anger både encoding_from och encoding_to)
• sort_cols – Vilka kolumner att sortera i formatet nr,nr och nr-nr (exempel 1,2,4 eller 1-2,4)
• sort_cols_order – Vilken ordning att sortera kolumner på. Om du har tre kolumner, du kan sortera dessa med t.ex. asc,desc,asc.
• add_ext_auto – Lägg till filändelse csv (om det inte är angivet i source_files). Sätt denna till ”no” om du inte vill att denna filändelse ska läggas till med automatik.
• float_divider – Om du hämtar flytttal/decimaltal från csv – använd detta tecken för att separera heltal och decimal (e.g. 6,3 och 1,3 istället för 6.3 och 1.2 etc)
• pagination – Talar om paginering ska vara aktivt (yes) eller inte (no). Standard är att paginering inte är aktivt.
• pagination_below_table – Visa paginering nedanför tabellen. Paginering måste vara aktivt för att denna inställning ska ha någon effekt.
• pagination_above_table – Visa paginering ovanför tabell (Pagineringen måste vara aktivt för att detta attribut ska ha någon effekt)
• pagination_start – Starta från rad vid pagineringen (Det är generellt nästan alltid port 1 som är ledigt)
• pagination_text_start – Visning av länk till första paginationen. Sätt till ”” om du inte vill visa detta alternativ.
• pagination_text_prev – Visning länk för föregående pagination. Sätt till ”” om du inte vill visa detta alternativ.
• pagination_text_next – Visning länk för nästa pagination. Sätt till ”” om du inte vill visa detta alternativ.
• pagination_text_last – Visning av länk till sista paginationen. Sätt till ”” om du inte vill visa detta alternativ.
• pagination_rows – Antal rader att visa för varje paginering
• pagination_links_max – Visar länkar (1,2,3… upp till 10 länkar som standard). Sätt värdet till noll om du inte vill visa ”pagineringslänkar”
• hidetable_load – Göm tabell om pageload är satt till ”yes”
• hidetable_reset – Gömmer tabellen när man klickat på återställ/reset om denna är satt till yes (annars kommer hela tabellen att visas även om hidetable_load är satt till yes)
• search_functionality – Gör tabellen sökbar
• searchbutton_text – Text för sökknapp (search_functionality måste vara aktivt för att den här inställningen ska ha någon effekt)
• resetbutton_text – Återställer knapptext (search_functionality måste vara aktiverat för att den här inställningen ska ha någon effekt)
• searchinput_placeholder – Anger en platshållare-text för sökningsfältet. Default är tomt.
• notfound_message – Skriv ut meddelande till användare om det inte finns något sökresultresultat. (search_functionality måste vara satt till yes för att denna inställning ska fungera)
• search_requiredchars – Hur många tecken som måste anges när man gör en sökning. Standardvärde 0 talar om att det inte finns något krav på antal tecken.
• search_requiredchars_message – Skriv ut ett meddelande till användare om krav på antal tecken inte uppfylls när en sökning görs. Om denna inte är angiven så kommer ett standardvärde att anges.
• search_realtime – Sätt till yes om sökningen ska ske i realtid, dvs om användaren inte behöver trycka på enter för att sökningen ska ske. Det är en delay på cirka en sekund när användaren har tryckt ner en tangent.
• htmltags_autoconvert – Sätt denna till yes om du vill att länka skall skapas med automatik: (), img, mailto ”malinglänkar (link with mailto:).
• htmltags_autoconvert_newwindow – Om det är vanliga länkar, så öppna upp dessa i ett nytt fönster. Denna inställning har endast någon effekt när attributet htmltags_autoconvert är satt till yes.
• htmltags_autoconvert_imagealt – Anger alt-tagg för alla bilder eller hämta beskrivning baserat på specifik kolumns värde (e.g. Om denna är satt till 2 så hämta värdet från andra kolumnen för den raden som bilden finns i)
• totals_cols_bottom – Lägger till totalsummeringar för angivna kolumner längst ner i tabellen (exempel: 1,2,4 och 1-2,4)
• totals_cols_bottom_empty – Vad det ska stå när det inte finns någon beräkning.
• totals_cols_prefix – Add prefix to the total column(s) (e.g. $10)
• totals_cols_suffix – Add suffix to the total column(s) (e.g. 10$)
• totals_cols_bottom_title – Skriver ut en specifik titel (Skriver över när totals_value och totals_cols_bottom är tomma)
• totals_cols_bottom_title_col – Which column to set this specific title at
• total_percentage_above_table – Show total percentage of a specific value above table. Ignored if total_percentage_chechkvalue and total_percentage_col is not set.
• total_percentage_below_table – Show total percentage of a specific value below table. Ignored if total_percentage_chechkvalue and total_percentage_col is not set.
• total_percentage_checkvalue – Check percentage of a specific value in a specific column. totals_pecentage_col must be specified.
• total_percentage_col – Which column to check in. total_percentage_chechkvalue must be specified for this to work
• 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 – Number of decimals to show when showing total percentage
• downloadable – Om denna är satt till yes så kommer en knapp att visas för att ladda ner csv-fil baserat på den skapade tabellen.
• downloadable_text – Vilken text som ska stå på knappen där man laddar ner csv-filen.
• downloadable_filename – What filename to use when downloading
• api_cdn – (Applicable when fetching json) Set this to no if you want to use wordpress api (could fail with cloudflare for unknown reason)
• fetch_interval – Set to daily, hourly or weekly. This is how often the actual fetch from source is done. It’s only done when requesting the page with this shortcode on. This would make sense to use for external files even if it’s possible to use with local files as well. For this to work you must have specified a html_id!
• debug_mode – Om satt till yes, så kommer värden att skrivas ut samt felsökningsinformation som kan hjälpa till vad man behöver göra för att det ska fungera. (Om denna inte är satt så kommer det bli fel men de kommer inte att visas för användaren)

Standardvärden

• [csvtohtml_create editable=”no” responsive=”yes” css_max_width=760 css_min_devicewidth=768 css_max_devicewidth=1024 title=”{none}” html_id=”{none}” html_class=”{none}” source_type=”visualizer_plugin” path=”{none}” fetch_lastheaders=”0″ source_files=”{none}” csv_delimiter=”,” exclude_cols=”{none} include_cols=”{none}” table_in_cell_cols=”{none}” table_in_cell_header=”More data” filter_data=”{none}” filter_data_ucfirst=”no” filter_operater=”equals” filter_removechars=”{none}” filter_col=”{none}” eol_detection=”cr/lf” convert_encoding_from=”{none}” convert_encoding_to=”{to}” sort_cols=”{none}” sort_cols_order=”asc” add_ext_auto=”yes” float_divider=”.” pagination=”no” pagination_below_table=”yes” pagination_above_table=”no” pagination_start=1 pagination_text_start=”Start” pagination_text_prev=”Prev” pagination_text_next=”Next” pagination_text_last=”Last” pagination_rows=”10″ pagination_links_max=”10″ hidetable_load=”no” hidetable_reset=”no” search_functionality=”no” searchbutton_text=”Search” resetbutton_text=”Reset” searchinput_placeholder=”” notfound_message=”no” search_requiredchars=”0″ search_requiredchars_message=”” search_realtime=”no” htmltags_autoconvert=”no” htmltags_autoconvert_newwindow=”no” htmltags_autoconvert_imagealt=”” totals_cols_bottom=”{none}” totals_cols_bottom_empty=””{none}” totals_cols_prefix=”” totals_cols_sufffix=”” totals_cols_bottom_title=”{none}” totals_cols_bottom_title_col=”{none]” total_percentage_above_table=”yes”, total_percentage_below_table=”no”, total_percentage_checkvalue=”{none}”, total_percentage_col=”{none}”, total_percentage_text=”{none}”, total_percentage_decimals=”0″, downloadable=”no” downloadable_text=”Download as csv” downloadable_filename=”export_csvtohtml.csv” api_cdn=”yes” fetch_interval=”{none}” debug_mode=”no”]

Titta på instruktioner och exempel här (engelska): http://wibergsweb.se/plugins/csvtohtml/ (Du kan också ladda ner BETA-version av premium plugin här gratis)
Om du gillar pluginet, vänligen fundera på att donera eller skriva en recension.. Om du donaerar: paypal info@wibergsweb.se. Beloppet spelar ingen roll. Jag gillar kaffe! 🙂