Dokumentacja klasy ElibriProduct
Reprezentacja produktu. Więcej...
Metody publiczne | |
| __construct ($xml_fragment) | |
| Konstruuj obiekt na bazie fragmentu xml-a. | |
| no_contributors () | |
| Jeśli produkt nie ma żadnego autora, to ta metoda zwróci true, inaczej false. | |
| unnamed_persons () | |
| Jeśli autorzy nie są wymienieni z nazwisko, to zwróć true (praca zbiorowa) | |
| translators () | |
| authors () | |
Atrybuty publiczne | |
| $product_form | |
| fizyczna forma produktu (kod ONIX) - patrz ElibriDictProductFormCode | |
| $product_form_name | |
| fizyczna forma produktu jako String, np. 'BOOK' - patrz ElibriDictProductFormCode | |
| $product_composition | |
| informacja, czy produkt jest pakietem. W tej chwili tylko wartość '00' - produkt samodzielny | |
| $height | |
| wysokość - w milimetrach | |
| $width | |
| szerokość - w milimetrach | |
| $thickness | |
| grubość - w milimetrach | |
| $weight | |
| waga - w gramach | |
| $ean | |
| EAN produktu - NULL, jeśli taki sam, jak ISBN13 ($isbn13) | |
| $isbn13 | |
| ISBN13 produktu (bez myślników) | |
| $isbn13_with_hyphens | |
| ISBN13 produktu (depracated, wartość identyczna z polem isbn13) | |
| $issn | |
| ISSN produktu (bez myślników), NULL jeżeli nie istnieje. | |
| $issn_with_hyphens | |
| ISSN produktu (z myślnikami), NULL jeżeli nie istnieje. | |
| $number_of_pages | |
| ilość stron | |
| $edition_statement | |
| Numer wydania, jako string. | |
| $edition_type | |
| Informacja o typie wydania (kod ONIX) - patrz ElibriDictProductType. | |
| $edition_type_name | |
| Informacja o typie wydania jako string, np. 'LARGE_PRINT_EDITION'. | |
| $edition_type_description | |
| Informacja o typie wydania opisowo, np. 'edycja z powiększoną czcionką'. | |
| $number_of_illustrations | |
| Liczba ilustracji. | |
| $duration | |
| czas trwania nagrania - jeśli jest to audiobook, w minutach | |
| $file_size | |
| wielkość pliku - w megabajtach | |
| $publisher_name | |
| nazwa wydawnictwa | |
| $publisher_id | |
| numeryczne ID wydawnictwa w bazie Elibri | |
| $city_of_publication | |
| miasto publikacji | |
| $imprint_name | |
| nazwa imprintu, jeśli książka jest wydana pod imprintem jeśli to pole jest uzupełnione, to proszę tą właśnie nazwę pokazywać jako nazwę wydawnictwa klientowi końcowemu | |
| $reading_age_from | |
| zalecany minimalny wiek czytelnika | |
| $reading_age_to | |
| zalecany maksymalny wiek czytelnika | |
| $table_of_contents | |
| Treść spisu treści, instancja ElibriTextContent. | |
| $description | |
| Opis książki, instancja ElibriTextContent. | |
| $short_description | |
| Krótki opis, instanca ElibriTextContent. | |
| $reviews = array() | |
| Lista recenzji - lista instancji ElibriTextContent. | |
| $excerpts = array() | |
| Lista fragmentów - lista instancji ElibriTextContent. | |
| $series = array() | |
| Lista serii, do których należy produkt, lista dwuelementowych list, gdzie pierwszy element jest nazwą serii, a drugi element numerem w serii (opcjonalnie) | |
| $series_names = array() | |
| Lista nazwa serii. | |
| $front_cover | |
| Informacja o okładce - instancja ElibriSupportingResource, patrz również $supporting_resources. | |
| $title | |
| Tytuł - String. | |
| $subtitle | |
| Podtytuł książki. | |
| $collection_title | |
| Tytuł produktu na poziomie kolekcji. | |
| $collection_part | |
| Numer na poziomie kolekcji. | |
| $full_title | |
| Pełen tytuł tytułu. | |
| $original_title | |
| tytuł oryginału | |
| $trade_title | |
| tytuł handlowy | |
| $parsed_publishing_date = array() | |
| Informacja o dacie wydania w postaci listy wartości. Może być pusta, albo zawiera tylko rok, albo rok i miesiąc, albo rok, miesiąc i dzień wydania, w zależności od posiadanych informacji. Uwzględnia datę końca wyłączności, tzn. jeśli produkt jest sprzedawany na wyłączność przez jakiś czas, to ta data uwzględia ten okres i jest równa końcowi okresu wyłączności. | |
| $publishing_date | |
| Data premiery - instancja ElibriPublishingDate. Nie uwzględnia wyłączności sprzedaży. | |
| $premiere | |
| $record_reference | |
| RecordReference - jednoznaczny identyfikator książki, jedyny, który ma gwarancje niezmienności. | |
| $notification_type | |
| $deletion_text | |
| w wyjątkowej sytuacji, gdy rekord zostanie wykasowany, w tym polu znajdzie się informacja o przyczynie usunięcia rekordu | |
| $cover_type | |
| rodzaj okładki, np. twarda | |
| $cover_price | |
| cena okładkowa | |
| $currrent_price_until | |
| do kiedy będzie obowiązywać dotychczasowa cena | |
| $future_cover_price | |
| przyszła, zapowiedziana cena okładkowa | |
| $future_price_from | |
| od kiedy będzie obowiązywać nowa cena okładkowa | |
| $vat | |
| stawka VAT | |
| $pkwiu | |
| symbol PKWiU | |
| $cn_code | |
| kod CN | |
| $country_of_manufacture | |
| $preview_exists | |
| flaga bool, czy dla produktu istnieje podgląd | |
| $number_of_pieces | |
| ilość elementów (puzzle, gry planszowe) | |
| $players_number_from | |
| min. ilość graczy - gry planszowe | |
| $players_number_to | |
| max. ilość graczy - gry planszowe | |
| $playing_time_from | |
| min. czas gry - gry planszowe | |
| $playing_time_to | |
| max. czas gry - gry planszowe | |
| $current_state | |
| status wydawniczy - wartość String - jedna z: 'announced', 'preorder', 'published', 'out_of_print' Więcej... | |
| $related_products = array() | |
| Produkty o identycznej treści, ale innej formie fizycznej (lista instancji ElibriRelatedProduct) | |
| $supply_details = array() | |
| Informacja o dostępności produktów w sieci dystrybucji (lista instancji ElibriSupplyDetail) | |
| $additional_trade_information | |
| Dodatkowa klasyfikacja sprzedażowa używana przez wydawcę, w tej chwili wykorzystywana jedynie przez grupę Foksal. | |
| $contributors = array() | |
| Lista twórców związanych z książką - lista instancji ElibriContributor. | |
| $languages = array() | |
| Lista języków, w jakich napisana jest książka, lista instancji ElibriLanguage. | |
| $subjects = array() | |
| Lista kategorii, do których należy produkt - lista instancji ElibriSubject. | |
| $keywords = array() | |
| Lista słów kluczowych (tagów) | |
| $thema_subjects = array() | |
| Lista kategorii Thema, do których należy produkt - lista instacji ElibriSubject. | |
| $supporting_resources = array() | |
| Lista plików towarzyszących produktowi - patrz również $cover_cover, lista instancji ElibriSupportingResource. | |
| $publisher | |
| Informacje o wydawnictwie - instanja ElibriPublisher, patrz też $publisher_id i $publisher_name. | |
| $publishing_status | |
| kod ONIX-a, patrz $current_state | |
| $proprietary_identifiers = array() | |
| Tablica identyfikatorów produktów w hurtowniach, w postaci tabeli asociacyjnej nazwa hurtowni => identyfikator. | |
| $sales_restrictions | |
| Czy produkt jest sprzedawany na wyłączność w jeden sieci na jakiś czas? true albo false. | |
| $sales_restrictions_info | |
| Jeśli produkt będzie sprzedawany na wyłączność, to tutaj znajdziesz szczegółowe informacje, instancja ElibriSalesRestriction. | |
| $sale_restricted_to_poland | |
| Czy sprzedaż produktu jest ograniczona do teresu Polski? (flaga bool) | |
| $unlimited_licence | |
| Czy licencja jest nieograniczona czasowo (tylko produkty elektroniczne, bool) | |
| $licence_limited_to_before_type_cast | |
| Data końca licencji na sprzedaż w formacie YYYYMMDD (tylko produkty elektroniczne, jeśli $unlimited_licence jest False) | |
| $parsed_licence_limited_to | |
| Data końca licencji na sprzedaż jako Array(rok, miesiąc, dzień) - (tylko produkty elektroniczne, jeśli $unlimited_licence jest False) | |
| $licence_limited_to | |
| Data końca licencji na sprzedaż, jako instancja DateTime, (tylko produkty elektroniczne, jeśli $unlimited_licence jest False) | |
| $digital_formats | |
| Dostępne formaty elektronicznych produktów (lista z wyborem wartości: MOBI, EPUB, PDF, MP3) | |
| $technical_protection | |
| Sposób zabezpieczenia pliku (tylko elektroniczne produktu). Możliwe wartości: WATERMARK, DRM, NONE. | |
| $excerpt_info | |
| Czy istnieje informacja o możliwości udostępnienia fragmentu książki (tylko produkty elektroniczne - flaga bool) | |
| $excerpt_publishing_allowed | |
| Jeśli $excerpt_info jest True, to flaga $excerpt_publishing_allowed zawiera informację, czy wydawca zgadza się na opublikowanie fragmentu e-booka. | |
| $excerpt_publishing_with_limit | |
| Jeśli $excerpt_publishing_allowed, to flaga $excerpt_publishing_with_limit zawiera informcję, czy wydawca nałożył limit na wielkość publikowanego materiału. | |
| $excerpt_limit_quantity | |
| Jeśli $excerpt_publishing_with_limit jest True, to w polu $excerpt_limit_quantity jest informacja na temat limitu co do ilości publikowanego materiału. | |
| $excerpt_limit_unit | |
| Jednostka miary, w którym wyrażona jest liczba w polu $excerpt_limit_quantity (w tej chwili CHARACTERS lub PERCENTAGE) | |
| $excerpt_infos = array() | |
| Informacje o fragmentach (dotyczy produktów cyfrowych) - lista instancji ElibriExcerptInfo. | |
| $file_infos = array() | |
| Informacje o plikach master (dotyczy produktów cyfrowych) - lista instancji ElibriFileInfo. | |
| $safety_contact | |
| Dane podmiotu odpowiedzialnego za produkt. | |
| $carries_ce_logo = False | |
| Produkt Ma logo ‘CE’ | |
| $carries_unsuitable_for_children_below_3_logo = False | |
| Produkt jest oznaczony symbolem ’nieprzeznaczony dla dzieci poniżej 3 roku życia’ | |
| $carries_en71_logo = False | |
| Produkt posiada certyfikat EN71. | |
| $minimum_age_warning | |
| Tekstowe ostrzeżenie dotyczące wieku. | |
| $toy_safety_warning | |
| Tekstowe ostrzeżenie o bezpieczeństwie produktu. | |
| $declaration_of_conformity_url | |
| Link to pliku PDF dokumentującego nadanie certyfikatu EN71. | |
Opis szczegółowy
Reprezentacja produktu.
Dokumentacja atrybutów składowych
◆ $current_state
| ElibriProduct::$current_state |
status wydawniczy - wartość String - jedna z: 'announced', 'preorder', 'published', 'out_of_print'
- 'announced' - informacja o produkcie jest szczątkowa, ale wydawnictwo zdecydowało się ją opublikować. Można taką informację umieścić w dziale zapowiedzi.
- 'preorder' - dane o rekordzie są kompletne. Jeśli masz zaufanie do wydawcy, to możesz uruchamiać przedsprzedaż
- 'published' - książka została opublikowana
- 'out_of_print' - wydawca wyraził przekonanie, że nakład książki jest wyczerpany, choć w dalszym ciągu książka może być dostępna w hurcie
◆ $premiere
| ElibriProduct::$premiere |
Jeśli $parsed_publishing_date składa się z trzech elementów (czyli ma informację o dokładnej dacie), to pole $premiere reprezentuje tą informację w postaci instancji DateTime
